Skip to content

Releases

v2 FULL VERS

Choose a tag to compare

@lihfolk-cy lihfolk-cy released this 29 Oct 19:46

LihFolk V2 2.5.0: turn your AI into a Roblox game studio, without burning your tokens

LihFolk V2 is a Claude Code plugin with 22 skills that makes your AI build Roblox games the way experienced developers do, powered by a vault of 1,300+ original expert notes you can also read yourself in Obsidian. An optional asset pack adds original models, materials, skies, animations and VFX.

Most AI coding help for Roblox fails in the same ways: outdated APIs, insecure remotes, lost player data, laggy builds and "AI slop" art. LihFolk fixes that at the source. Your AI looks up how it's really done, follows proven rules and checks its own work, and it's engineered from the ground up to spend as few tokens as possible doing it.


⚡ Token-light by design

Knowledge is only useful if it doesn't eat your context and your usage. Every layer of LihFolk was measured and cut down:

What your AI pays for Before Now Saving
Always-loaded cost of all skills (per session) ~1,720 tokens for 19 skills ~1,150 tokens for 22 skills −33% while adding 3 skills
Main knowledge router (loads on Roblox tasks) ~1,610 tokens ~940 tokens −42%
One vault search ~745 tokens ~575 tokens −23%
Same lookup the old way (grep the index + read 2 notes) ~1,600 tokens, 3–5 tool calls ~575 tokens, 1 call −64%
Main-model tokens per benchmark run, lookups delegated vs notes read directly 67k 49k −27%

How it stays this lean:

  • Descriptions only, until needed. A skill's full instructions load only when the task calls for it. Until then it costs just its one-line description.
  • A cheap model does the reading. Vault lookups run in a separate agent on a small, fast model. It searches 1,300+ notes and returns only the facts, gotchas and note titles, so your main model never wades through raw notes and your conversation stays clean.
  • One-call search. vault.py ranks 1,300+ notes and returns the best 3 as short summaries in a single call. It drops boilerplate, prints repeated points once, and lists sections only for the top note.
  • Summaries first, sections second. Every note has a generated TL;DR. The AI opens a full section only for the exact number or rule it needs, and never reads a whole long note.
  • Lookups only where they pay. Plain Luau logic and long-stable APIs skip the vault entirely. Lookups are kept for limits, defaults, prices, policy and 2025–26 changes, where AI training data is out of date.
  • Batching that doesn't starve answers. Related questions share one lookup, up to 6 per call, so you pay for fewer round trips without facts getting dropped.
  • No fix-it-again loops. Every API name is checked against the real Roblox API before the AI answers, and the code-check hook catches 17 common mistakes as files are written. Wrong code that needs a second or third pass is often the biggest hidden token cost, and this cuts it off.
  • Cheaper than the last version at the same accuracy: on a fresh held-out test, 2.5.0 used about 4% fewer main-model tokens per run than 2.4.0 and scored slightly higher.

The main-model figures leave out the small lookup model's own tokens, which are far cheaper per token.


⬇️ Downloads

File What it is
LihFolk-V2-Complete-2.5.0.zip (1.3 GB) Everything: vault + plugin + full asset pack + learning dataset, with a START HERE guide
Source code (zip) (41 MB) Just the vault and plugin
LihFolk-Asset-Pack-*.zip The asset pack in parts (Models, Materials, Skies, Animations-VFX)

🪶 39 GB → 41 MB. V1 was a 39 GB download. V2's vault and plugin are 41 MB, about 950× smaller, with more knowledge than ever. The heavy art moved into an optional pack you only grab if you want it.


🤖 What the plugin does

It works on its own. Ask for anything Roblox in plain words, and the right skill loads by itself.

  • 🧭 Knowledge router: finds the right notes for each task and applies their mistakes and checklists, sized to the task
  • ⚙️ 19 drop-in Luau systems: session-locked data saving, safe purchases and receipts, shop, eggs under 2026 odds rules, codes, daily rewards, rebirth, quests, leaderboards (/lihfolk:new-system)
  • ⚔️ Combat and ability VFX: slashes, impacts, projectiles, auras, AoE warnings, shields, beam lasers, heals, teleports, level-up bursts, camera shake and hit-stop, with budgets and server-validated replication
  • 🔊 SFX: layered, pooled sounds synced to animation markers, using only properly licensed sources
  • 🎨 UI: the LihFolk cartoon/simulator UI kit, responsive layouts for phone, PC and console, and Figma → Roblox conversion
  • 🗺️ Worldbuilding: maps, towns, dungeons and lobbies that read as designed, with placement and audit tools
  • 🧊 Modelling: Blender modelling with an automatic quality gate (symmetry, budgets, correct export), stylised creatures and model import
  • 🎓 Game design: tutorials and onboarding that keep new players, plus a trend-game playbook (/lihfolk:trend-game)
  • 🛡️ Safety: secure remotes, DataStore safety, anti-exploit review, monetization compliance, performance audits, debugging
  • ✅ Quality control:
    • a code check catches 17 common Roblox mistakes every time the AI writes Luau;
    • /lihfolk:audit reviews your whole project;
    • generated work must score 8.5/10;
    • a blind multi-agent council gives objective verdicts (/lihfolk:council).
  • 📦 Asset finder: searches and imports from the asset pack (/lihfolk:assets)

📚 What the vault contains

1,300+ original notes across 59 sections. It's an interlinked Roblox textbook you can browse in Obsidian, written so both people and AI can use it.

  • Scripting and systems: Luau from basics to advanced, a cookbook, client/server, remotes, networking, DataStores, game systems, physics and vehicles, game math, procedural generation
  • Security and performance: anti-exploit, debugging deep dives, profiling, mobile budgets
  • Art and feel: UI/UX, worldbuilding, level design, lighting, VFX, audio, animation and rigs, modelling, Blender, voxel and stylised styles, materials, game feel
  • Design and business: genres, economy, monetization, live ops, marketing, thumbnails and CTR, community, careers
  • Learn from the best: case studies plus 31 teardowns of viral hits and high-craft studios
  • Always current: every 2025-2026 change, including the Async renames, deprecations, Server Authority, Input Actions, TextChat, age checks and DataStore limits
  • Reference: 32 engine reference cards plus a limits and defaults cheat sheet, verified against the official docs
  • Find anything: one-call search, 250+ "symptom → cause → fix" lines, an API atlas and a glossary
  • Celestial look: starry theme, coloured folders, rainbow graph and moon home page, with no community plugins needed

Every note is built to be trusted:

  • trust labels (Roblox docs / Measured / Rule of thumb / Unverified);
  • common mistakes, each with the symptom you'll see;
  • a ship checklist;
  • dated facts.

🔬 Checked, not just claimed

  • Proven on unseen questions: on 4 fresh test sets written without access to the vault and graded blind, the plugin scored 91-94%, up to 13 points above the same AI without it:
Test set With the plugin Same AI without it
C 91.3% 88.3%
D 93.7% 87.4%
E 91.9% 84.3%
F 92.3% 79.2%
  • No made-up APIs: every API name in the notes is checked against a dated snapshot of the real Roblox API, plus the newest doc deprecations.
  • Code that compiles: all 1,800+ Luau code blocks are compiled with the official Luau compiler.
  • Notes that agree: 39 key limits and defaults are cross-checked across every note automatically.
  • Search that finds it: the right note is in the top 3 for 93% of held-out tasks.
  • Checked on every push, and REVIEWERS.md lists each claim with the command that verifies it.

📦 The asset pack (optional)

815 model kit pieces · 204 PBR materials · 48 skies · R15 animations · VFX, all original and blind-reviewed before inclusion. Free to use and modify in your games, commercial ones included.


🚀 Install

Claude Code plugin

/plugin marketplace add lihfolk-cy/v2-vault
/plugin install lihfolk@lihfolk

Already installed? /plugin marketplace update lihfolk

  • Obsidian: unzip, then Open folder as vault → LihFolk Vault V2 → start at 000 Home
  • Asset pack: unzip, then set LIHFOLK_ASSETS to the LihFolk Asset Pack folder, or run /lihfolk:assets setup
  • Coming from V1: Obsidian → Manage vaults → remove V1 → open V2, then delete the old 39 GB folder
  • Other AI tools (OpenCode, Codex, Cursor…): the vault works through AGENTS.md; plugin features are Claude Code only

📄 Licence

Free to use on your projects and to ship in your own games, commercial ones included. Please don't re-upload, resell or repackage the vault, plugin, skills or asset pack. Full terms are in LICENSE.md.

Not affiliated with or endorsed by Roblox Corporation.