Skip to content

Commit 2e4c6f9

Browse files
chore: deep project analysis and documentation updates
Co-authored-by: robertpelloni <673434+robertpelloni@users.noreply.github.com>
1 parent 95da752 commit 2e4c6f9

20 files changed

Lines changed: 123 additions & 33 deletions

.gitignore

Lines changed: 6 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,7 @@
1-
.gradle
2-
build
3-
out
4-
bin
5-
*.class
6-
*.bak
1+
.gradle/
72
build/
8-
.gradle/8.8/executionHistory/executionHistory.bin
9-
.gradle/8.8/executionHistory/executionHistory.lock
10-
.gradle/8.8/fileHashes/fileHashes.bin
11-
.gradle/8.8/fileHashes/fileHashes.lock
12-
.gradle/8.8/fileHashes/resourceHashesCache.bin
13-
.gradle/buildOutputCleanup/buildOutputCleanup.lock
14-
.gradle/8.8/checksums/checksums.lock
15-
.gradle/8.8/checksums/md5-checksums.bin
16-
.gradle/8.8/checksums/sha1-checksums.bin
17-
.gradle/8.8/executionHistory/executionHistory.bin
18-
.gradle/8.8/executionHistory/executionHistory.lock
19-
.gradle/8.8/fileHashes/fileHashes.bin
20-
.gradle/8.8/fileHashes/fileHashes.lock
21-
.gradle/8.8/fileHashes/resourceHashesCache.bin
22-
.gradle/buildOutputCleanup/buildOutputCleanup.lock
23-
.gradle
24-
.gradle
25-
.gradle
3+
*.class
4+
*.log
5+
*.tmp
6+
7+
references/grafx2/doc/quickstart.rtf

.gitmodules

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -124,3 +124,15 @@
124124
[submodule "bobcoin"]
125125
path = bobcoin
126126
url = https://github.com/robertpelloni/bobcoin
127+
[submodule "references/defold"]
128+
path = references/defold
129+
url = https://github.com/defold/defold
130+
[submodule "references/love2d"]
131+
path = references/love2d
132+
url = https://github.com/love2d/love
133+
[submodule "references/phaser"]
134+
path = references/phaser
135+
url = https://github.com/phaserjs/phaser
136+
[submodule "libs/bobui"]
137+
path = libs/bobui
138+
url = https://github.com/robertpelloni/bobui

AGENTS.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,3 @@
11
# Agents Instructions
2-
Please refer to [LLM_INSTRUCTIONS.md](LLM_INSTRUCTIONS.md) for core instructions.
2+
Please refer to [docs/UNIVERSAL_LLM_INSTRUCTIONS.md](docs/UNIVERSAL_LLM_INSTRUCTIONS.md) for core instructions.
3+
Always remember to bump the version in `VERSION.md`, update `CHANGELOG.md`, and include the version number in the git commit message.

CHANGELOG.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,16 @@
22

33
All notable changes to this project will be documented in this file.
44

5+
## [2.0.31] - 2026-04-26
6+
7+
### Added
8+
- Created `VISION.md`, `MEMORY.md`, `DEPLOY.md`, and `TODO.md` to comprehensively document project goals, observations, deployment steps, and upcoming tasks.
9+
- Added new references for Defold, Love2D, Phaser, and `bobui` to the git submodules for feature analysis and integration.
10+
- Updated `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, `GPT.md`, `copilot-instructions.md`, and `LLM_INSTRUCTIONS.md` to point to the universal LLM instructions.
11+
12+
### Changed
13+
- Bumped `VERSION.md` to `2.0.31`.
14+
515
## [2.0.30] - 2026-04-06
616

717
### Added

CLAUDE.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,3 @@
1-
# Claude Instructions
2-
Please refer to [LLM_INSTRUCTIONS.md](LLM_INSTRUCTIONS.md) for core instructions.
1+
# Agents Instructions
2+
Please refer to [docs/UNIVERSAL_LLM_INSTRUCTIONS.md](docs/UNIVERSAL_LLM_INSTRUCTIONS.md) for core instructions.
3+
Always remember to bump the version in `VERSION.md`, update `CHANGELOG.md`, and include the version number in the git commit message.

DEPLOY.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
# DEPLOY: Deployment Instructions
2+
3+
The project consists of multiple deployable artifacts:
4+
5+
## Server Deployment (Docker)
6+
1. Ensure Docker and docker-compose are installed.
7+
2. Configure `server.properties` or environment variables for database credentials.
8+
3. Run `docker-compose up --build -d` to launch the Game Server, STUN Server, and MySQL database.
9+
10+
## Client Deployment
11+
1. Build the client using Gradle: `./gradlew :client:build`
12+
2. Run the client: `./gradlew :client:run`
13+
14+
## Web Deployment (Hetzner / bobsgameweb)
15+
*(To be expanded as the web port is finalized)*
16+
- Target: 30-player cross-platform multiplayer, leaderboards, and live editing.
17+
- Ensure all WebSocket proxy layers are configured to bridge web traffic to the Netty TCP backend.

GEMINI.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,3 @@
1-
# Gemini Instructions
2-
Please refer to [LLM_INSTRUCTIONS.md](LLM_INSTRUCTIONS.md) for core instructions.
1+
# Agents Instructions
2+
Please refer to [docs/UNIVERSAL_LLM_INSTRUCTIONS.md](docs/UNIVERSAL_LLM_INSTRUCTIONS.md) for core instructions.
3+
Always remember to bump the version in `VERSION.md`, update `CHANGELOG.md`, and include the version number in the git commit message.

GPT.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,3 @@
1-
# GPT Instructions
2-
Please refer to [LLM_INSTRUCTIONS.md](LLM_INSTRUCTIONS.md) for core instructions.
1+
# Agents Instructions
2+
Please refer to [docs/UNIVERSAL_LLM_INSTRUCTIONS.md](docs/UNIVERSAL_LLM_INSTRUCTIONS.md) for core instructions.
3+
Always remember to bump the version in `VERSION.md`, update `CHANGELOG.md`, and include the version number in the git commit message.

HANDOFF.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -181,3 +181,20 @@ This session focused on modernizing the internal Swing-based Editor tools (`Spri
181181
* **Undo System:** The undo system works (`CompoundEdit`) but could be more robust (limit stack size, memory usage).
182182
* **Animation Features:** Timeline view, Tags (Idle, Walk).
183183
* **Visual Dialogue Graph:** The current editor is text-based with preview. A node-based editor would be a massive improvement.
184+
185+
---
186+
187+
## Handoff - Google Jules (Version 2.0.31)
188+
189+
### Action Taken
190+
1. **Documentation Updates:** Created `VISION.md`, `MEMORY.md`, `DEPLOY.md`, `TODO.md` in the root.
191+
2. **LLM Instructions:** Appended universal instructions link to agent files.
192+
3. **Submodules:** Added git submodules for `defold`, `love2d`, `phaser`, and `bobui`.
193+
4. **Version Bump:** Bumped the version to `2.0.31` in `VERSION.md` and updated `CHANGELOG.md`.
194+
195+
### Next Steps
196+
- Port the legacy Swing `bgeditor` to JavaFX and/or C++ (Qt6) using `bobui`.
197+
- Port bgeditor to Web.
198+
- Implement advanced selection tools (Polygon Lasso) in the Sprite Editor.
199+
- Build the UI for Generative AI tools (Text-to-Sprite, Image-to-Sprite).
200+
- Integrate submodules related to generative AI.

LLM_INSTRUCTIONS.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,3 +14,6 @@ This is the Java (LibGDX) implementation of the unified puzzle engine.
1414
- Refer to [AGENTS.md](AGENTS.md) for agent roles.
1515
- Refer to [VERSION.md](VERSION.md) for the current version.
1616
- Refer to [CHANGELOG.md](CHANGELOG.md) for historical changes.
17+
18+
## 4. Universal Omni-Workspace Instructions
19+
For workspace-wide context, rules on merging, and cross-repo interactions, refer to the root [docs/UNIVERSAL_LLM_INSTRUCTIONS.md](docs/UNIVERSAL_LLM_INSTRUCTIONS.md).

0 commit comments

Comments
 (0)