https://github.com/pikminguts92/mackiloha

A suite of modding software for hacking milo engine based games
https://github.com/pikminguts92/mackiloha

archive band dta guitar hack harmonix-games hero midi milo mod ps2 rock script texture xbox

Last synced: 2 days ago
JSON representation

A suite of modding software for hacking milo engine based games

• Host: GitHub
• URL: https://github.com/pikminguts92/mackiloha
• Owner: PikminGuts92
• License: mit
• Created: 2017-05-31T00:20:57.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2024-04-13T04:41:28.000Z (7 months ago)
• Last Synced: 2024-04-13T18:13:01.051Z (7 months ago)
• Topics: archive, band, dta, guitar, hack, harmonix-games, hero, midi, milo, mod, ps2, rock, script, texture, xbox
• Language: C#
• Homepage:
• Size: 1020 KB
• Stars: 18
• Watchers: 8
• Forks: 7
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Mackiloha [![CI](https://github.com/PikminGuts92/Mackiloha/workflows/CI/badge.svg)](https://github.com/PikminGuts92/Mackiloha/actions?query=workflow%3ACI)

A suite of modding software for hacking milo engine based games. This is still very much a work-in-progress project. So don't expect perfection. Although feel free to submit [issues](https://github.com/PikminGuts92/Mackiloha/issues) for any bugs found. The latest CI build can be found [here](https://github.com/PikminGuts92/Mackiloha/actions/workflows/ci.yml).

**[DOWNLOAD](https://github.com/PikminGuts92/Mackiloha/releases/latest)**

# Overview

## Ark Helper

CLI tool for unpacking/repacking .ark archives from milo. Should work with Amplitude (PS2) up to RB3. For dta/dtb serialization support, download [dtab](https://github.com/mtolly/dtab) and place in same directory as ark helper executable.

Usage:

- Extract ark archive:

  - Everything: `arkhelper ark2dir main.hdr ext_dir -a`

  - Everything + convert scripts: `arkhelper ark2dir main.hdr ext_dir -a -s`

- Repack ark archive:

  - Amp/KR/AntiGrav PS2: `arkhelper dir2ark ext_dir gen_dir -n "MAIN" -v 2`

  - GH1/GH2 PS2: `arkhelper dir2ark ext_dir gen_dir -n "MAIN"`

  - GH2 360: `arkhelper dir2ark ext_dir gen_dir -e`

  - RB1 Patch: `arkhelper dir2ark ext_dir gen_dir -n "patch_ps3" -e -f -v 4`

  - RB2/TBRB/GDRB PS3: `arkhelper dir2ark ext_dir gen_dir -n "main_ps3" -e -v 5`

  - RB3 360: `arkhelper dir2ark ext_dir gen_dir -n "main_xbox" -e -v 6`

## P9 Song Tool

CLI tool to assist in venue authoring for TBRB.

Usage:

- Create new project: `p9songtool newproj -n temporarysec project_temporarysec`

- Create project from milo: `p9songtool.exe milo2proj -m temporarysec.mid temporarysec.milo_xbox project_temporarysec`

- Generate milo from project: `p9songtool.exe proj2milo project_temporarysec temporarysec.milo_xbox`

## SuperFreq

CLI tool for unpacking/packing rnd archives from milo games. These files usually use the extensions: .gh, .kr, .milo, .rnd

**Warning:** Game compatibility is *very* limited. Editing archives for games beyond GH2 will have mixed results.

Usage:

- Extract rnd archive: `superfreq milo2dir test.milo_ps2 ext_test --convertTextures --preset=gh2`

- Create rnd archive: `superfreq dir2milo ext_test test.milo_ps2 --preset=gh2`

  - Note: Any `.png` files in the "Tex" directory will automatically be converted and serialized to milo encoded textures