Tags
Creators
Details
All versions
0.5.0
Beta
MLua 0.5.0 - Forge 1.20.13 weeks ago 16
Compatibility
Minecraft: Java Edition
1.20.1
Platform
Forge
Supported environments
Client and server
Changes
Changelogs
This mod focuses on making things faster and more stable and and easier to work with. Most changes are behind the scenes, so the Lua API should still feel familiar.
Runtime And Lua
- Java and Lua now work together more smoothly.
- Java calls are faster with less reflection overhead.
- Scripts, services, and libraries are now easier to manage.
- Reloading now cleans up leftover resources automatically.
- Added support for addon modules, textures, and shared assets.
- Reloads now skip scripts that haven't changed.
- Reworked script loading and lifecycle handling.
- Script errors are now less likely to affect other scripts.
- Client and server tasks now run on the correct threads more consistently.
- Added checks to prevent callbacks from running too early in multiplayer.
- Updated support for Java proxies, Luau libraries, math helpers, and reflection.
World And Entity APIs
- Reworked world and entity APIs for consistency.
- Vectors, positions, raycasts, and transforms now behave more consistently.
- Updated chunk handling and block entity support.
- Entity searches and filters are now more reliable.
- Player features are now split into simpler APIs.
- Entity APIs now behave more consistently across Minecraft versions.
- Entity data is now saved and cleaned up more reliably.
- Reworked entity spawning, navigation, and nearby entity searches.
Scripted Entities
- Reworked how scripted entities move, target, and attack.
- Entity movement and behavior now use shared systems.
- Entity queries now create less temporary data.
- Entity callbacks can now be replaced more safely during gameplay.
- Entity models and render callbacks now have their own ownership registries.
Items And Inventory
- Item callbacks now work more consistently across supported versions.
- Reworked handling for item use, bows, offhand actions, and equipment.
- Empty inventory slots now behave consistently.
- Fixed inventory tick issues involving empty slots.
- Equipment slots now use consistent indexing with clearer documentation.
- Added tests covering common item and inventory interactions.
- Reorganized services for advancements, scoreboards, particles, and world generation.
Registry And Generated Content
- Registry handling is now separate from the runtime lifecycle.
- Registering items, blocks, entities, models, sounds, and other content is now simpler.
- Data packs can now be generated during dedicated server startup.
- Recipes are now checked for invalid data before being generated.
- Recipe ingredients and encoding are now handled separately.
- Registry changes can now be rolled back more safely when scripts are replaced.
- Registry lookups now reuse cached values to reduce overhead.
Rendering And Animation
- Rendering and animation systems now have clearer ownership.
- Render callbacks now run on the correct client thread with clearer error reporting.
- Camera movement and FOV transitions are now smoother.
- First-person hand animations now reuse cached data.
- Model transforms and pose restoration are now more consistent.
- Reworked animation ownership, texture handling, and reload cleanup.
- Blockbench animations and custom world rendering now use shared systems.
- HUD rendering now skips work it doesn't need.
- Cameras, animated models, dynamic textures, and render callbacks now share more rendering state.
UI And Input
- Reworked how screens and GUI elements are managed.
- Screens, widgets, and click handling now use simpler APIs.
- Native widget methods are now resolved more safely.
- Keyboard input and keybinds now run on the correct client thread.
- Screen callbacks no longer run before the client is ready.
- Closing vanilla screens now clears leftover runtime references.
- Chat, menus, screen layers, and GUI controls are now split into smaller APIs.
Services And Documentation
- Reorganized world, entity, player, GUI, and other services.
- Java reflection and service integration are now more consistent.
- Addon documentation now has its own lifecycle.
- Updated API docs, navigation, texture paths, and service references.
- Added more starter scripts, shared types, Java services, and first-person support.
- Script loading now supports the updated namespace and addon system.
- Quests, advancements, gamerules, enchantments, and events now have simpler service handling.
Performance And Cleanup
- Cut down on repeated work by reusing cached data.
- Fewer temporary objects are created, reducing memory overhead.
- Old animations, callbacks, GUI elements, and runtime resources are now cleaned up more reliably.
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle. To learn more about the Modrinth Maven API, click here.
Note: When available, you should use the creator's maven repo instead as it will have transitive dependency information that the Modrinth Maven API does not. You may also end up with duplicate dependencies if you use a mix of Modrinth and non-Modrinth Maven repositories for your dependencies, because the group identifier will be different when served through the Modrinth Maven API.
Maven coordinates:
Version ID:
build.gradle:
repositories {
exclusiveContent {
forRepository {
maven {
name = "Modrinth"
url = "https://api.modrinth.com/maven"
}
}
// forRepositories(fg.repository) // Uncomment when using ForgeGradle
filter {
includeGroup "maven.modrinth"
}
}
}
// Standard Gradle dependency
dependencies {
implementation "maven.modrinth:zcXWXnhQ:q0NA8DwG"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:zcXWXnhQ:q0NA8DwG"
}

