yt-toaster / mc3dslib

python lib for mc3ds

mc3dslib

• A python Library for Minecraft 3DS, allowing for easy Modification of the SaveGames, and romfs Files.
• This Library is being Developed by: @Wolfyxon, @STBrian, @Cracko298, and @YT-Toaster.

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:

• mc3dslib Documentation.

mc3dslib Function(s):

• 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 (Test): convert_save(folder_path, world_icon_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.