cracko298/mc3dslib

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

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:

• mc3dslib Documentation.

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)