Skip to content

A python Library for Minecraft 3DS, allowing for easy Modification of the Game and romfs Files.

License

Notifications You must be signed in to change notification settings

Cracko298/mc3dslib

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

80 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mc3dslib

  • A python Library for Minecraft 3DS, allowing for easy Modification of the SaveGames, and romfs Files.
  • An online installer/Updater was just released alongside version v0.1.0-beta🎉.
  • Lastest Release: v0.1.3.

Note:

  • Documentation is Extremely barebones currently. A more in-depth documentation will be added soon.
  • I've made a Documentation on both MC3DS's Options.txt, and ARGB .3DST, if you want a more "in-depth explantaion of things."

Read the Wiki:

Download(s):

  • Download The Updater/Installer Here.

mc3dslib Overview:

  • Extract Bytes: extract_bytes(filename, arg1, arg2)
  • Convert Bytes: convert_bytes(bytestring,order)
  • Extract Color: extract_colors(image_path)
  • Invert Colors: invertclrs(image_path)
  • Set Green Hue: greenify(image_path)
  • Set Orange Hue: orangify(image_path)
  • Set Blue Hue: bluify(image_path)
  • Set Red Hue redify(image_path)
  • Grab Meta Data: meta_grab(image_path)
  • Material To Json: mat2json(file_path)
  • Convert Options: convert_options(file_path,output_file_path)
  • Revert Options: revert_options(file_path,output_file_path
  • Blang To Json: toJson(blang_file)
  • Json To Blang: fromJson(json_file)
  • Extract Head: extract_head(image_path)
  • Convert To PNG: image_convert(image_path)
  • Create .r3dst: create_r3dst(image_path)
  • Copy Lines: copy_lines(filename, line_number, mode)
  • Convert CDB To LDB: console2bedrock_cdb(folder_path, optional_offset)
  • Convert VDB To Log: console2bedrock_vdb(folder_path)
  • Copy World Information: console2bedrock_cdb(folder_path, optional_offset)
  • Convert Full World: convert_save(folder_path, world_icon_path)
  • Create Converted World Lockage: convert_lockage(file_path)
  • Convert Stuff into .mcworld: zip_convert_contents
  • Convert Images to 3DST: convert_2_etc2(image_path)
  • Convert 3DST to Images: convert_2_img(etc2_path)
  • Get .3DST Image Demensions: get_3dst_demensions(etc2_path)
  • Get Image Image Demensions: get_img_demensions(image_path)

Importing the Module(s):

Defualt Importing:

import mc3dslib
from mc3dslib import BlangFile
from mc3dslib import *
import mc3dslib as mc3ds

Blang Conversion(s):

Initializing the File:

import mc3dslib

file = mc3dslib.BlangFile().open("en_GB.json") # Initialzation of Example File

JSON TO BLANG

import mc3dslib

input_file_path = ".\\" ## Any Valid JSON file can go here
blang_file = mc3dslib.BlangFile().fromJson(input_file_path)

BLANG TO JSON

import mc3dslib

blang_file = mc3dslib.BlangFile().open("en_GB.json")

output_path = ".\\" # Any Valid Path can go here
blang_file.toJson(output_path)

Panning Additions:

  • Convert Achievements
  • Revert Achievements
  • Extract Arms
  • Extract Legs
  • Extract Body

Credit(s):

  • @Wolfyxon - Few of the Functions in the Code.
  • @STBrian - MC3DS Blang Format Conversion Code.
  • @Cracko298 - Developer of Most Functions in the Code.
  • @YT-Toaster - Few of the Functions in the Code.
  • olverimcDISC - His map was used as a test to conversion methods from 3DS to Bedrock
Oliver's Map (LoCity - https://www.minecraft3ds.net/maps/locity)