+
# SurvivorCore
-**A batteries-included, creator-extensible survival game framework for Roblox.**
+**A batteries-included, creator-extensible survival game engine for Roblox.**
+
+[](https://github.com/TemujinCalidius/SurvivorCore/releases)
+[](https://github.com/TemujinCalidius/SurvivorCore/actions/workflows/ci.yml)
+[](LICENSE)
+
+**[π Website](https://temujincalidius.github.io/SurvivorCore/)** Β· **[π Docs](docs/)** Β· **[πΉ Demo](https://makertube.net/w/tyn8JEMG3CaMbTXid8osdU)** Β· **[β¬ Releases](https://github.com/TemujinCalidius/SurvivorCore/releases)**
+ Survival stats & HUD
+Health, energy, hunger, thirst, fatigue, blood, poison β ticking, draining, biting back. A clean, restyleable HUD drives only the data.
+
+ 
+
+ v0.5.0 Β· pre-release
+
+
+
+
+ v0.5.0 Β· pre-release
+
+ The survival game engine for Roblox
++ A batteries-included, creator-extensible framework. Survival stats, inventory, gathering, + crafting, combat, mobs & AI β wired together, restyleable, and authorable + without code. If you know Roblox Studio, you can build a survival game. +
+
+ Get started
+ View on GitHub
+
+ Free & open source (MIT) Β· drop-in .rbxm or Wally
+
+ Batteries included
+The core survival loop ships working β stats, inventory, gather, craft, fight β not a pile of parts to wire.
+
+
+ No-code friendly
+A Studio admin plugin creates items, weapons, ammo and mobs β with full stats β and zero scripting.
+
+
+ Yours to re-skin
+UI is real, restyleable Instances driven by attributes. Override any default; nothing is locked.
+
+
+ Server-authoritative
+Hits, harvests and crafts are validated on the server. Content-free by design β you bring the game.
+
+
+ Everything the survival loop needs
+Each system is configurable, hook-extensible, and authorable as tagged Instances or no-code.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Inventory, hotbar & crafting
+Slots + carry-weight, a 9-slot hotbar, equipment, and hand crafting in a tabbed menu β server-authoritative, drag-and-drop.
+Gathering
+Tag any mesh Gatherable: hold-E or tool-swing, per-hit yields, reaction hooks (a reed sways, a tree fells and leaves a stump).
Combat β melee & bow
+Click to swing; or aim a bow, draw for power, and loose arrows that arc under real weight. One server-validated kill-event schema.
+Mobs & AI
+A shared FSM substrate: hostile mobs chase & attack, passive animals flee. Behavior is data β faction picks the profile.
+No-code admin plugin
+Create items, weapons, ammo and mobs from a Studio form β damage, range, arrow curve, weight, aggro, leash β and drop them into the world.
+
+
+ See it in action
+The whole UI suite runs out of the box β restyle it, or keep the clean defaults.
+
+
+
+ Mobs & combat
+ Gathering & crafting
+ No-code creation
+ Inventory & hotbar
+
+
+ Get started
+Drop it into ReplicatedStorage, register your content, and call start().
+
+
+
+ Install
+Grab the drop-in model from the latest release, or add it with Wally:
+# wally.toml
+[dependencies]
+SurvivorCore = "temujincalidius/survivorcore@0.5.0"β¦or drop SurvivorCore.rbxm into ReplicatedStorage.
+
+ Boot it
+local SurvivorCore = require(ReplicatedStorage.SurvivorCore)
+
+-- register content (or author it no-code in the admin plugin)
+SurvivorCore.Items.register({ id = "berry", name = "Wild Berries", stack = 20 })
+SurvivorCore.Mobs.register({ id = "husk", faction = "hostile", health = 60 })
+
+SurvivorCore.start() -- boots stats, inventory, gathering, crafting, combat, mobsβ¦The HUD loader calls startClient() for you. That's it.