$ show FiguraMC/Figura
Figura is a Minecraft mod (client-side with optional server-side backend) that allows players to fully customize their avatar's appearance, animations, sounds, particles, and behavior using Lua scripting. The architecture is a multi-loader (Fabric, Forge, Quilt, NeoForge) client mod with a server-side plugin (Spigot) for avatar storage, permissions, and networking. The client-side core includes a Lua runtime (LuaJ) with a sandboxed API exposing over 30 modules (e.g., models, textures, sounds, events, keybinds, action wheel, networking, math). Avatars are defined by Blockbench models, Lua scripts, textures, and sounds, all packaged into NBT files. The rendering pipeline hooks into Minecraft's vanilla rendering via extensive mixins to replace player models, modify armor, cape, elytra, and nameplates. The server-side backend (Figura Server Bridge) provides avatar upload/download, user data, pings, and permission management via WebSocket or custom Minecraft packets. Key entry points include the `Avatar` class (lifecycle), `FiguraLuaRuntime` (script execution), `AvatarRenderer` (rendering), `PermissionManager` (access control), and `NetworkStuff` (backend communication). External dependencies include LuaJ, Gson, nv-websocket-client, and Minecraft's own libraries.
The LLM identified 6 files worth highlighting for reuse:
A fully-featured 3D vector class with Lua operator overloads, swizzle, and transformation methods. Demonstrates clean copy-on-write defensive design and is self-contained, making it reusable in any Java project needing a Lua-exposed vector type.
A 4x4 matrix class with full Lua metamethods, caching, and inversion. Isolated from Minecraft internals, it can be extracted as a standalone math utility for 3D transformations.
Centralized transformation state for model parts, supporting position, rotation, scale, pivot, texture overrides, colors, and light. Used by all render tasks and vanilla parts. Demonstrates a clean stack-based pattern for hierarchical transformations.
Granular permission system with categories (Blocked/Low/Default/High/Max) and per-feature limits (instructions, complexity, particles, sounds). Self-contained and could be reused in any mod needing tiered permissions.
Base class for GUI widgets with child management, layout, and event handling. Demonstrates a reusable widget hierarchy that could be extracted for custom UI frameworks.
A simple but effective resource refill pattern (e.g., for particle/sound limits). Self-contained and reusable for any rate-limiting or resource pool scenario.