BE3 project

You are inside of an ubuntu VM. You may install / remove programs as needed. If the disk runs out of space, you may free up space.

Guides:

• guides/adding_a_block.md
• guides/adding_a_game.md
• guides/adding_a_plugin_editor.md
• guides/testing_a_gui.md

Do not:

• When making changes to serialization formats or network requests, do not consider backwards compatibility with existing clients or data. The project is still early, and it is fine to ask the user to delete all their data. The crash handler in block-app will offer this automatically.
• Do not use unicode symbols for icons, either use an icon library or no icon at all.
• Do not edit README.md. If it is out of date, you may say so in your handoff message.
• Don't use worktrees. If using subagents, run them sequentially rather than in parallel.

Verification:

• ./scripts/verify: This is the primary way to check your work, and should run frequently, not just once at the end. Run using a 10 minute timeout in the tool call arguments so it doesn't convert itself to a background task.
  • This will run all project tests and clippy lints
  • It will autofix formatting, clippy fixable rules, and it will autofix to enforce these project-specific rules: It will delete all code comments & doc comments, it will structure test folders & files to the project's one test per file standard, and it will automatically move+rename mod.rs files to be in the parent folder named after the folder instead.
  • Default to running ./scripts/verify whenever you want to check that your code compiles or passes tests, including during iterative work, not only right before committing.
  • Only fall back to manual cargo check / cargo test / cargo build / cargo clippy calls for special cases: e.g. verify failed and you need a faster/narrower loop to isolate the fix, or you need output verify doesn't surface. Treat these as the exception, not the default iteration loop, and always finish with a ./scripts/verify run before committing.
• PATH="/home/ubuntu/.local/android-build/gradle-8.11.1/bin:$PATH" ./scripts/build --target android --android-sdk /home/ubuntu/Android/Sdk: run this for changes that affect features specific to Android.
• ./scripts/build --target web: run this for changes that affect features specific to web
• Do not perform any manual GUI verification. Do not run the GUI app or use the browser tool.

Do:

• Use commit message format type: message. Add Co-Authored-By: (model name).
• After running verification, commit and push changes in git.
• You may push a change even if it still needs GUI verification or other verification that you are unable to perform.