z64a / star-rod

Tools for editing Paper Mario 64 assets
MIT License
11 stars 3 forks source link

Star Rod

Release Download Build Status #star-rod channel in the Star Haven Discord

A suite of tools for editing assets from the Paper Mario (2000) decompilation.

Star Rod supports Windows, Linux, and macOS.

Download Star Rod

To get started with modding Paper Mario, see docs.starhaven.dev.

Development

Star Rod is written in Java and uses the build tool Gradle. We recommend Visual Studio Code as your editor.

To set up Star Rod for local development, follow these instructions:

  1. Clone this repo, e.g. gh repo clone z64a/star-rod
  2. Open it in Visual Studio Code: code star-rod
  3. At the bottom right hand corner, a prompt will appear to install the recommended Visual Studio Code extensions; click Yes. This will install the Java and Gradle editor extensions. You can see the Gradle elephant icon in the Activity Bar.
  4. Open the Explorer. Alternatively, press Ctrl+Shift+E / ⇧⌘E.
  5. Navigate to src/main/java/app/StarRodMain.java.
  6. Click the "Run" button above the line declaring the main method (this type of button is called a CodeLens):

https://github.com/z64a/star-rod/blob/110ea7d6268f98a2bf565880572203bd066a9c1f/src/main/java/app/StarRodMain.java#L66

Creating a ZIP locally

Use the release - createReleaseZip task in Gradle.