mercurial-magic's Introduction
Mercurial Magic v01 Author: hex_usr Dependencies: nall (by byuu) hiro (by byuu) icarus (by byuu) daedalus (based on icarus by byuu, modified by hex_usr) License: ISC Mercurial Magic is an MSU1 package manager that can export MSU1 games to the following environments: higan v095 higan v096-v105 and up SD2SNES and Snes9x Each item in that list takes a different, incompatible format for MSU1 games, which is why Mercurial Magic exists. =============================================================================== MSU1 Pack specification MSU1 packages are ZIP archives with the extension .msu1. These ZIP archives are only allowed to use 2 compression methods: Store (0x00) and Deflate (0x08). This effectively means that no MSU1 package can exceed 4GB in size, and no individual file's uncompressed size can exceed 4GB either. The restriction is enforced by nall. They can follow 2 separate structures depending on the legality of the original game: MSU1 Pack for Commercial Game.msu1/ patch.bps Patch msu1.rom Data track track-1.pcm Audio track track-2.pcm Audio track track-3.pcm... Audio tracks... MSU1 Pack for Homebrew Game.msu1/ program.rom Game Program data.rom (optional) SPC7110 Data dsp1.program.rom (optional) Coprocessor firmware dsp1.data.rom (optional) Coprocessor firmware msu1.rom Data track track-1.pcm Audio track track-2.pcm Audio track track-3.pcm... Audio tracks... Do not create packs with the latter format if they are for commercial games. Doing so constitutes illegal distribution of copyrighted material. =============================================================================== Export formats There are 2 major export formats to fit different needs. Game Pak: The cartridge folder format for higan versions v096-v105 and up, with an optional manifest for higan v095. All files except for patch.bps are exported exactly as they are. If patch.bps is present, the patch will be applied to a ROM, then the patched ROM will become "program.rom" in the Game Pak. The generated manifest, if any, is a hybrid manifest for higan versions v095 and v096-v105 and up. Exporting manifests requires icarus to be in the same directory as Mercurial Magic. To generate a manifest for higan v095, daedalus is also required (included in Mercurial Magic's source). SD2SNES/Snes9x: A format in which all files share the name of the game's title, as required by SD2SNES and Snes9x. All files except for patch.bps are renamed during export. If patch.bps is present, the patch will be applied to a ROM, then the patched ROM will become "<Game Name>.sfc" in the package. If this is a homebrew, and more than 1 ROM (such as SPC7110 data or coprocessor firmware) are bundled directly, they will be merged together into a single .sfc file. No manifest is exported. The files themselves will be put into an "SD2SNES-Snes9x" directory in the same directory as the .msu1 pack. The directory itself is not to be copied onto your SD card; only its contents. The "sd2snes" directory on the SD card is for the SD2SNES firmware and is not shown in the SD2SNES's file browser.
mercurial-magic's People
Forkers
orbeaRecommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. ๐๐๐
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google โค๏ธ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.