Skip to content
This repository has been archived by the owner on Dec 16, 2024. It is now read-only.
/ mc3dslib Public archive

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

81 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Development for mc3dslib has ceased.

Please try mc3dslib2 for modification to files and other things.

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)