Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cracko298/mc3dslib
A python Library for Minecraft 3DS, allowing for easy Modification of the Game and romfs Files.
https://github.com/cracko298/mc3dslib
3dst abgr argb converter etc2 library mc3ds minecraft minecraft-3ds minecraft3ds module nintendo nintendo-3ds nintendo3ds python python3
Last synced: 2 months ago
JSON representation
A python Library for Minecraft 3DS, allowing for easy Modification of the Game and romfs Files.
- Host: GitHub
- URL: https://github.com/cracko298/mc3dslib
- Owner: Cracko298
- License: apache-2.0
- Created: 2024-01-17T15:45:31.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-08-28T00:15:52.000Z (5 months ago)
- Last Synced: 2024-08-28T01:32:58.810Z (5 months ago)
- Topics: 3dst, abgr, argb, converter, etc2, library, mc3ds, minecraft, minecraft-3ds, minecraft3ds, module, nintendo, nintendo-3ds, nintendo3ds, python, python3
- Language: Python
- Homepage:
- Size: 14 MB
- Stars: 13
- Watchers: 2
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](https://github.com/Cracko298/MC3DS-Options-Documentation), and [ARGB .3DST](https://github.com/Cracko298/MC-3DST-Documentation), if you want a more "in-depth explantaion of things."**
## Read the Wiki:
- **[mc3dslib](https://github.com/Cracko298/mc3dslib/wiki) Documentation.**
## Download(s):
- **Download The Updater/Installer [Here](https://github.com/Cracko298/mc3dslib/releases/download/v0.1.0-beta/mc3dslib_updater.py).**
# 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:
```py
import mc3dslib
from mc3dslib import BlangFile
from mc3dslib import *
import mc3dslib as mc3ds
```
## Blang Conversion(s):
### Initializing the File:
```py
import mc3dslib
file = mc3dslib.BlangFile().open("en_GB.json") # Initialzation of Example File
```
### JSON TO BLANG
```py
import mc3dslib
input_file_path = ".\\" ## Any Valid JSON file can go here
blang_file = mc3dslib.BlangFile().fromJson(input_file_path)
```
### BLANG TO JSON
```py
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](https://github.com/Wolfyxon) - Few of the Functions in the Code.**
- **[@STBrian](https://github.com/STBrian) - MC3DS Blang Format Conversion Code.**
- **[@Cracko298](https://github.com/Cracko298) - Developer of Most Functions in the Code.**
- **[@YT-Toaster](https://github.com/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)
```