Giter VIP home page Giter VIP logo

mgsgblz's Introduction

mgsgbLz

GB Metal Gear Solid: Ghost Babel script tool. Game uses MTE and LZ compression for text. This tool can work with it.

Synopsis:

mgsgbLz -r <input>                      
mgsgbLz -ra <inputs> <weights>
mgsgbLz -d -b <input> <offs>     
mgsgbLz -d -s <input>            
mgsgbLz -c -i <inst> <fst> <ptr> 
mgsgbLz -c -b <input>            
mgsgbLz -t <input>               
Options:
-h     
-v     

Description

***-r *** Rebuild dictionary from plain script file.

-ra Rebuild adaptive from multipe files, specifying weight of this file (what part of dictionary will be devoted to this script file). For instance, mgsgblz -ra "instance #00.txt" 1 "instance #03.txt" 1 "instance #08.txt" 3 "instance #09.txt" 2 will build dictionary mostly from "instance #08.txt", compressing it with MTE at a higher rates.

-d -b Decompress one LZ block from input ROM at offset.\n\

-d -s Decode full script from input gameboy ROM.

-c -i Encode one inst with given fst message and ptr. Use for script translation.

-c -b Compress one input plain binary block with LZ. Useful for tiles/nametables binary compression for further ROM insertion.

-t Test check input plain script for various issues. In almost all cases you don't want line length to be more than 24 symbols. In normal game script (everywhere, except Instance #00), there shouldn't be more than two lines with [nl] symbols. You should use [clr] or [scrl] for next newline. All valid symbols are mentioned in table.tbl. -t command will warn you in case you violate any of those rules. Also during compression, tool will warn you if your instance will not fit WRAM or appropriate ROM space.

Options:

-h Show help.

-v Show version.

See additional files in release archive. Usage examples are in compress.bat file. Recommended translation scheme:

  1. translate script instance

  2. mgsgblz -t "instance #XX.txt" (checking and correcting possible errors)

  3. buildMteDictionary.bat (rebuilding table from translated instances)

  4. compress.bat XX (for comperssion and insertion newly translated instance)

  5. check translation

  6. go to 4

Build:

stack setup
stack build

mgsgblz's People

Contributors

romhack avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

mgsgblz's Issues

Does mgslz have any plans to support Japanese roms?

Hi, I am Augen working on localization of Korean game rom.

The dialogue output method is expected to be similar to the English version. However, I noticed that the "block", "message" and "MteDictionary" positions of the dialogue are different.

It is easy to work with the English version, but the number of characters that can be used is less than that of the Japanese version.
English font : 00DF
Japanese font : 00
EF, F701~F7FF

Please make it to support Japanese roms.
I would like to help gamers in my country to play this game in Korean.
(Sorry for the poor English.)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo 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.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.