https://github.com/datkat21/mii-creator
mii creator app
https://github.com/datkat21/mii-creator
3ds app mii switch typescript wii wiiu
Last synced: 6 months ago
JSON representation
mii creator app
- Host: GitHub
- URL: https://github.com/datkat21/mii-creator
- Owner: datkat21
- Created: 2024-10-07T06:48:03.000Z (about 1 year ago)
- Default Branch: dev
- Last Pushed: 2025-02-21T22:06:37.000Z (8 months ago)
- Last Synced: 2025-03-31T10:01:10.711Z (7 months ago)
- Topics: 3ds, app, mii, switch, typescript, wii, wiiu
- Language: TypeScript
- Homepage: https://mii.nxw.pw
- Size: 91.4 MB
- Stars: 98
- Watchers: 9
- Forks: 19
- Open Issues: 27
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Mii Creator App
Create and share Mii characters online with just a few clicks!
## Credits
- Uses a locally hosted version of the [mii-unsecure.ariankordi.net](https://mii-unsecure.ariankordi.net) [API](https://github.com/ariankordi/FFL-Testing/tree/renderer-server-prototype) by [ariankordi](https://github.com/ariankordi) used to generate 3D Mii heads and icons.
- A [fork](https://github.com/datkat21/FFL-Testing-with-hats) is used that adds hat support.
- [mii-js](https://github.com/PretendoNetwork/mii-js) library used for interacting with Mii data in a JavaScript-friendly way
- [Some utility code](https://github.com/datkat21/mii-creator/tree/master/src/external/mii-frontend) "borrowed" from arian's website for conversion, QR codes, etc.
- Custom Mii Maker music by [objecty](https://x.com/objecty)
## Features
This app uses a custom, extended version of the FFSD Mii format that I call the MiiCreator format (.miic), allowing for extra colors and glasses from the Switch, while still allowing you to convert back to FFSD for 3DS/Wii U.
- [x] Real 3D rendering unlike Mii Studio
- [x] Change parts and colors of the Mii
- [x] Save and load Miis in your library
- [x] Save a Mii QR code
- [x] Render to PNG file
- [x] Save/load .FFSD/.miic
- [x] Create your own renders inside the app
- [x] Custom hats (for fun!)
## Contributing
I'm open to contributions if you want to help on the project!
## Model Credits
Some of the custom hat models are provided by the Models Resource:
- [Top Hat](https://www.models-resource.com/nintendo_switch/supersmashbrosultimate/model/30314/)
- [Ribbon & Bow](https://www.models-resource.com/3ds/nintendogscats/model/30239/)
Thanks to [Timimimi](https://github.com/Timiimiimii) for creating the new hat models:
- Cat Ears
- Straw Hat
- Hijab
- Bike Helmet
## Setting up development
1. Make sure you have [Bun](https://bun.sh/) installed on your device. This is used for compiling all of the TypeScript code into JavaScript for the client.
2. Clone this repository, and run the `bun i` command to install dependencies.
3. In one terminal, run `bun build-ts` (if this doesn't work, try running `bun build.ts` to run the file), and in another, run `bun run serve`. If that doesn't work, try `bunx serve -l 3000 -C ./public`. (There is also an optional Go server if you want to use that over the bun server. Both seem to have a strange issue on Windows where you have to wait 5 seconds before you are allowed to refresh the page..)
4. Any changes you make should log in the build-ts terminal, and check the server on the second terminal to find the port. Live server is not advised when using my build script because it sometimes can refresh too much.