Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cracko298/mc-3ds-flip
Flips MC Skins (and Alot More) on The X & Y Axis from Java Edition to be used on Minecraft 3DS. Extremely simple CLI/GUI that "just works" no questions asked. With some advanced 3DST options sprinkled inside.
https://github.com/cracko298/mc-3ds-flip
3ds 3dst cli cli-app command-line-tool minecraft minecraft-3ds nintendo-3ds python python3
Last synced: about 1 month ago
JSON representation
Flips MC Skins (and Alot More) on The X & Y Axis from Java Edition to be used on Minecraft 3DS. Extremely simple CLI/GUI that "just works" no questions asked. With some advanced 3DST options sprinkled inside.
- Host: GitHub
- URL: https://github.com/cracko298/mc-3ds-flip
- Owner: Cracko298
- License: apache-2.0
- Created: 2023-07-17T18:12:22.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-12-08T01:18:44.000Z (about 1 year ago)
- Last Synced: 2023-12-09T01:31:46.116Z (about 1 year ago)
- Topics: 3ds, 3dst, cli, cli-app, command-line-tool, minecraft, minecraft-3ds, nintendo-3ds, python, python3
- Language: Python
- Homepage:
- Size: 9.49 MB
- Stars: 6
- Watchers: 4
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://www.paypal.me/cracko298)
# MC-3DS-Flip
- An CLI that "Just Works" with Minecraft .3DST Skins, Textures, and More.
- Inspired by [@DaniElectra](https://github.com/DaniElectra)'s Anime Channel [3DSTTOOL](https://github.com/DaniElectra/3DSTTool).
## MC-3DS-Flip (GUI)
- An W.I.P. GUI that "Just Works" with Minecraft .3DST Skins, Textures, and More.
- This is a **Work-In-Progress** Adaptation, and the current release only supports color extraction.
- I'm always looking for bugs, and squashing them. But sometimes these go unseen even by my standards. If you found a bug in the GUI, create an issue request via the **Tab** above!
# Features:
- Flips normal *.png Images From Java to MC-3DS.
- Can Flip Compiled *.3dst Files. ***Both X & Y Only Axis ATM***.
- Change Color of Compiled *.3DST Files. ***See [CLI/CLU Usage](https://github.com/Cracko298/Minecraft-3ds-Image-Flip/#cliclu-usage) for additional information***.
- Grab Data from Both File Types using the "**-g**" flag in the CLI
- Partial Conversion Support (Can Convert Between Both PNG and 3DST Somewhat).
- Brand new GUI (Graphical) being built from the ground up using some of the code from the CLI (Command-Line).
# Usage:
### CLI/CLU Usage:
```
# Utility Commands:
> .\m3dsflip help
# 3DST Commands:
> .\m3dsflip 3dstflip
> .\m3dsflip -c -invert
> .\m3dsflip -c -green
> .\m3dsflip -c -orange
> .\m3dsflip -c -red
> .\m3dsflip -c -blue
> .\m3dsflip -c -extract
> .\m3dsflip -g -meta
> .\m3dsflip -g -head
> .\m3dsflip -con <3dst_image_path>
# PNG Commands:
> .\m3dsflip yflip
> .\m3dsflip xflip
> .\m3dsflip -g -head
> .\m3dsflip -g -body
> .\m3dsflip -g -larm
> .\m3dsflip -g -rarm
> .\m3dsflip -g -lleg
> .\m3dsflip -g -rleg
> .\m3dsflip -con
```
### Command Explanation:
```
> .\m3dsflip
```
```
> .\m3dsflip = Call Executable
> = -c (Color Flag), -g (Grab Flag), -con (Convert Flag).
> = Commands Such as "yflip" or "3dstflip" (or Args Such as "-invert" or "-orange").
> = Image Path (If path has "speaces" within it, surround it in quotes. An Example: "C:\Windows\Users\batch user384\skin.png").
```
## Building:
```
> pyinstaller -F --strip --exclude-module numpy --exclude-module opencv --exclude-module cv2 --onefile "m3dsflip.py" --icon="favicon.ico"
```
## Source Usage:
```
python m3dsflip.py
```
## Notice:
- If you decide to change the color/hue of your *.3DST Skin.
- **I am not responsible for any data that might become corrupted, or if the output is not the desired result.**
- Blurry Images on this GitHub page do NOT reflect the quality (enlarged so you can see them).
- These Skin Hue Changes do **NOT** work on all skins. Make sure your *.3DST Skin is a compatible size: ***16.0kb***.
- **Converting Between Formats is VERY experimental. As such converting is not reccomended. But has been added.
- The "**-g**" Flag can either Grab .3DST MetaData, or Grab .PNG Body Parts currently.
# Download:
- **Compiled "CLI" Download Avaliable [Here](https://github.com/Cracko298/MC-3DS-Flip/releases/download/v0.5.75/m3dsflip.exe).**
- **Compiled "GUI" Download Avaliable [Here](https://github.com/Cracko298/MC-3DS-Flip/releases/download/v0.6.0/pyeethonfile.exe).**
## Road-Map (Updates/Patches):
```
1. finish the "-g" flag (Whicy will support grabbing multiple body parts of both Images). *(High Priority | 55% Way There).
2. A "-r" flag will be added flag to replace body parts with of Compiled .3DST Skins. *(Mid Priority)
3. Proper Flipping of Compiled .3DST Skins. *(High Priority)
4. Converting Between .PNG and Compiled .3DST Skins. *(Mid Priority | 50% Way There).
```
## Documentation on 3DST:
### You're In Luck!
- **I have made a simple [Documentation Repository](https://github.com/Cracko298/MC-3DST-Documentation) so you can make your Own Utilities!**
- **The "documentation" is a bit technical, so make sure you know how to read/write in Hex Moderately Fluently.**
# Image Gallery:
