hgame-gms2-safe-edit

Guide narrow, safe edits to hgame GMS2 GML code and systems.

Updated Sep 26, 2025
One-click install
npx skills add https://github.com/jacobbuizel/JRPG-system-based-on-GMS2 --skill hgame-gms2-safe-edit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hgame-gms2-safe-edit
Source: https://github.com/jacobbuizel/JRPG-system-based-on-GMS2/tree/main/.codex/skills/hgame-gms2-safe-edit
Command: npx skills add https://github.com/jacobbuizel/JRPG-system-based-on-GMS2 --skill hgame-gms2-safe-edit

SYSTEM DOCUMENTATION & REQUIREMENTS

Safe editing guidance for the hgame GameMaker Studio 2 JRPG project. Use when Codex or an agent needs to inspect, modify, refactor narrowly, debug, or extend this repository's GML code, GMS2 objects, rooms, scripts, save data, inventory, equipment, character, skill, menu, NPC, movement, audio, or room-state systems.

What problem does it solve?

Safe editing practices that reduce the risk of breaking runtime behavior, preserve save contracts, and keep project structure stable during modifications.

Core Features & Use Cases

  • Narrow-change guidance: avoid broad refactors and enforce existing data contracts and conventions.
  • Scoped edits: apply changes to scripts, objects, rooms, save data, inventory, equipment, character, skill, menu, NPCs, movement, audio, and room-state systems with documented safeguards.
  • Safe-workflow: steps for validation, migration planning, and rollback to ensure reversible edits.

Quick Start

Review the repository with rg to identify touched files and apply edits only to narrowly scoped scripts and objects per this guide.

Frequently Asked Questions about hgame-gms2-safe-edit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely refactor GML code in a GameMaker Studio 2 project?

Safely refactor GML code by enforcing narrow change scopes, preserving existing data contracts, and avoiding direct edits to .yy resources to maintain stable project structure.

What is the best way to modify GMS2 save data without breaking existing save formats?

Modify GMS2 save data without breaking formats by following documented safeguards, planning migrations carefully, and ensuring reversible edits through a structured validation and rollback workflow.

Can I extend GMS2 JRPG inventory and character systems without touching .yy resources?

Yes, you can extend GMS2 JRPG inventory and character systems by applying narrowly scoped edits exclusively to GML scripts and objects while leaving .yy resource files untouched.

Why does broad refactoring break runtime behavior in GameMaker Studio 2 projects?

Broad refactoring breaks runtime behavior in GameMaker Studio 2 because it risks violating established data contracts and altering room-state systems, which destabilizes the existing game logic.

How do I validate and rollback changes to GMS2 objects and room-state systems?

Validate and rollback changes to GMS2 objects and room-state systems by using a safe-workflow that includes inspection with rg, scoped script modifications, and documented rollback steps for reversible edits.

Does this safe editing guidance apply to GMS2 audio and NPC movement scripts?

Yes, this safe editing guidance applies to GMS2 audio and NPC movement scripts, providing scoped modification safeguards that preserve existing conventions and prevent runtime disruptions.