xlibs

Version: 1. 8. 2

GitHub | Changelog | На русском | Bugs, suggestions

xlibs is a modder's toolbox covering the full surface of what Anomaly mods typically need - entity queries, squad operations, smart terrain logic, stash manipulation, logging, profiling, event systems, and data structures.

The API design comes from reverse engineering the X-Ray engine and Anomaly internals, cross-referenced with patterns from the best modders in both the European and Russian STALKER modding traditions. Every function wraps engine quirks, guards against nil, and handles edge cases that would otherwise require each mod to solve independently.

Pure Lua where possible. No engine dependency unless necessary. No central loader - the engine auto-loads scripts on first access. Just call xlog.get_logger() or xsquad.find_squads() and it works.

Features

Entity and World

• []xcreature - Creature identification, type checks, translated names, money primitives[/]

  []xsquad - Squad search, scripted control, release, chase, iteration[/]

  []xsmart - Smart terrain queries, faction detection, capacity, arrival, conquest, job allocation[/]

  []xlevel - Level/map queries, game time, location names, vertex validation[/]

  []xobject - Server object and online game object resolution from any input type[/]

  []xinventory - Item categorization (per-NPC ammo tier), slot semantics, ammo config, item lifecycle, LTX policy primitives (load + classify + iterate surplus)[/]

  []xstash - Stash discovery, looting, filling, item filtering[/]

  []xdata - Unscriptable NPC/squad tables (traders, mechanics, story characters)[/]

  []xconst - X-Ray engine sentinel constants (invalid entity ID, invalid level vertex ID)[/]

  Data Structures

  • []xtable - Count, shuffle, sort, set merge and subtract[/]

    []xttltable - TTL key-value store, sliding window counter, token bucket, FIFO cache[/]

    []xslice - Time-sliced array iteration across frames[/]

    []xmath - Random sampling and partial shuffle[/]

    []xstring - String interpolation with {key} placeholders[/]

    []xtime - Game-time seconds accumulator (wraps engine game_time())[/]

    Diagnostics

    • []xlog - Buffered file logging with session management and rotation[/]

      []xprofiler - Microsecond code profiling via engine profile_timer[/]

      []xtrace - Trace ID generation for request tracking across modules[/]

      []xinspect - Deep table and userdata inspection, engine type identification[/]

      Effects