3C #4

Omena0 · 2026-03-11T08:43:03Z

Omena0
Mar 11, 2026
Maintainer

Plugging some old holes in the API. Full codebase cleanup. New extensions.

LootTable: weighted loot pools with conditional entries, rolls, bonus rolls, and stacked item generation
PlaceholderRegistry: register %placeholder% expansions with per-player context and batch resolve_many()
TabList: full tab-list customization with header/footer templates, fake entries, groups with prefix/priority sorting
Scheduler: cron-like real-world-time scheduling with @every() / @after() decorators and cancellation
StateMachine: per-entity/player state machines with on_enter/on_exit/on_tick callbacks and event-driven transitions
Schematic: extracted from Dungeon into standalone module (SchematicCapture.java + schematic.py)

@preserve decorator: hot-reload state persistence — caches return value to JSON and restores across /pjb reload
Custom events: fire_event(event_name, data) — scripts can fire and listen to custom events across scripts
Villager trade API: Villager.recipes (get/set), recipe_count, add_recipe(), clear_recipes()
Entity subtypes: ArmorStand, Villager, ItemFrame, FallingBlock, AreaEffectCloud proxy classes
Entity properties: velocity, fire_ticks, custom_name, gravity, glowing, invisible, invulnerable, silent, persistent, collidable, bounding_box, metadata
Entity AI goals: goal_types, remove_goal(), remove_all_goals()
Player: hidePlayer/showPlayer/canSee, openBook, sendBlockChange, sendParticle, cooldown management, statistics, getMaxHealth/setMaxHealth, bed spawn, compass target, PersistentDataContainer access
Block: getDrops, getHardness, getBlastResistance, PersistentDataContainer for tile entities
Item: durability, enchantments, item flags, isUnbreakable/setUnbreakable
World: game rules, world border, getHighestBlockAt, generateTree, getNearbyEntities, batchSpawn, structure API (save/load/delete/list), createWorld/deleteWorld
Entity.__bool__() via isValid()

Comprehensive docstrings added across all Python modules and extensions
Whitespace normalization and consistent spacing across Python source
Type annotations tightened: lazy imports, Optional callables, assertion guards
str.removeprefix() modernization replacing startswith() + slice
server.players de-awaited in guild, leaderboard, npc, region (was incorrectly awaited)
@preserve event handlers fixed: lambdas replaced with proper async def functions
Gradle deprecation linting enabled: -Xlint:deprecation
Gradle wrapper (8.5) added and committed

BridgeInstance: 24 pre-sized ArrayList/HashMap allocations (completions, handles, release ids, batch calls, responses, args, tab complete results, merchant recipe ingredients, sign lines, goal types, recipes, lore, item flags, structures, enchantments, spawn batches, tab list setter, process command)
BridgeInstance: getDrops → List.copyOf(), clearRecipes → List.of()
BridgeSerializer: stream→manual loop for list serialization, 6 pre-sized ArrayList/HashMap allocations, early List.of() return for null modifiers
SchematicCapture: 11 pre-sized collections (HashMap, LinkedHashMap, ArrayList, HashSet), 3 stream→manual loop conversions (sum, sort)
EventDispatcher: simplified getCachedMethod(), pre-sized lists in dispatchBlockMulti()
ScriptCommand, PermissionsFacade, RaycastFacade, RegionFacade, EntitySpawner: pre-sized result collections

_ENUM_TYPE_MAPPING moved to module-level constant (was recreated on every enum deserialization)
_JSON_SEPARATORS, _RESERVED_KWARGS frozenset, _MINECRAFT_PREFIXES tuple: module-level constants
event_batch handler inlined: avoids temp dict creation and full re-dispatch per payload
XYZ key check: direct "x" in d instead of frozenset.issubset(d.keys())
import math / import logging moved to module-level
__slots__ added to 27 classes across helpers and extensions
NPC: squared distance comparison, cached NPC coords outside player loop
Region: batch-fetch all player locations once per tick, inline bounds check
Mana: cached instance attributes as locals in regen loop
Bank: inlined transfer() to avoid double _save()
Levels: eliminated double xp lookup in add_xp, xp_to_next/progress avoid redundant bridge call
Ability: inlined remaining_cooldown to avoid double time.time() + double dict lookup
Leaderboard: tuple-based medal lookup
Quest: cached locals in async task loops
Guild: cached member set reference and pre-formatted message
Cooldown: single .get() lookup instead of in + []
_toml_write_table(): single-pass scalar/sub-table separation
UUID cache eviction: indexed deletion instead of slice allocation

Fixed server.players incorrectly awaited in guild, leaderboard, npc, region
Fixed @preserve event handler signature (lambda → async def)
Fixed setLore NPE when argument is not a list (added else branch with List.of())

Docs updated for all new extensions (LootTable, Placeholder, TabList, Scheduler, StateMachine)
Villager trade API documented
Type stubs updated for all new APIs and extensions
Gradle wrapper committed

This discussion was created from the release 3C.