{"id":"kashtheking/init","name":"init","scope":"kashtheking","platform":"roblox","description":"A module loader for Roblox games: point it at folders and it requires, initializes and starts every module in order, with OnPlayerAdded, OnHeartbeat and friends wired up for you.","version":"1.0.1","latest":"1.0.1","versions":["1.0.0","1.0.1"],"license":"MIT","licenseRating":"safe","licenseCaveats":[],"licenseVerified":true,"dependencies":{},"integrity":"70f7266aacf69b2047b4240dfe1738286da36a05e0e603162682317e29aa8950","likes":0,"downloads":0,"install":"forest install kashtheking/init","url":"https://forest.dev/p/roblox/kashtheking/init","files":"https://api.forest.dev/ai/package/roblox/kashtheking/init/files","readme":"# Init\n\n**A module loader for Roblox games.** Put your modules in folders. Init requires them in the order you choose, calls every module's `Init`, then every module's `Start`, and connects `OnPlayerAdded`, `Step`, `OnCharacterAdded` and the rest for you.\n\n📖 **Docs:** https://kashtheking.com/init/ · 🧩 **Plugin:** [Init Framework](https://create.roblox.com/store/asset/77164672536940/Init-Framework) · 📦 **Wally:** `kashtheking/init` · 💬 [Discord](https://discord.gg/6HYgCk22eD)\n\n\n\n## Install\n\n| You are... | Do this |\n| --- | --- |\n| New to scripting | Install the [Init Framework plugin](https://create.roblox.com/store/asset/77164672536940/Init-Framework), press **Setup**. [Guide](https://kashtheking.com/init/docs/install/no-code/) |\n| Using an AI (Claude, Cursor, ChatGPT) | Paste the prompt from [Install with AI](https://kashtheking.com/init/docs/install/with-ai/). |\n| Using Rojo + Wally | `Init = \"kashtheking/init@1.0.1\"` in `wally.toml`. [Guide](https://kashtheking.com/init/docs/install/wally/) |\n| Using Studio, no plugin | Drag `Init.rbxm` from [Releases](https://github.com/KashTheKing/init/releases/latest) into `ReplicatedStorage.Packages`. |\n\n## What it looks like\n\n```lua\n-- ServerScriptService/InitServer (Script)\nlocal Init = require(ReplicatedStorage.Packages.Init)\n\nInit.start({\n\t{ Folders = { ReplicatedStorage.Network } },\n\t{ Folders = { ReplicatedStorage.Services, ServerScriptService.Services }, Predicate = Init.matchesName(\"Service$\") },\n})\n```\n\n```lua\n-- ServerScriptService/Services/CoinService\nlocal CoinService = {}\n\nfunction CoinService.Init(self) self.Coins = {} end           -- own state only\nfunction CoinService.Start(self) end                           -- other modules are ready\nfunction CoinService.OnPlayerAdded(self, player) self.Coins[player] = 0 end\nfunction CoinService.OnPlayerRemoving(self, player) self.Coins[player] = nil end\n\nreturn CoinService\n```\n\n## This repository\n\n| Path | What |\n| --- | --- |\n| [`src/Init`](src/Init) | The package (`kashtheking/init`) |\n| [`templates`](templates) | Module templates (Service, Controller, Binder, ...), used by the plugin and by AI |\n| [`example`](example) | A starter place: boot scripts, folders, one service and one controller |\n| [`plugin`](plugin) | The Init Framework Studio plugin (FSL-1.1-ALv2) |\n| [`skills/init/SKILL.md`](skills/init/SKILL.md) | The AI skill (also a Claude Code plugin: `/plugin marketplace add KashTheKing/init`) |\n| [`docs`](docs) | The docs site (Moonwave) |\n| [`tests`](tests) | Lune tests: `lune run tests/run` |\n\n```sh\nrokit install                                   # rojo, wally, lune, selene, stylua, luau-lsp\nlune run tests/run                              # tests, no Studio needed\nselene src templates example plugin tests/run.luau\nrojo serve example.project.json                 # try the example in Studio\nrojo build plugin.project.json -o InitFramework.rbxmx   # after `wally install` in plugin/\n```\n\nMIT licensed, except `plugin/` ([FSL-1.1-ALv2](plugin/LICENSE.md): free to use and change, not for a competing product; each version becomes Apache-2.0 after two years). Promise is [evaera/roblox-lua-promise](https://github.com/evaera/roblox-lua-promise) (MIT), bundled so Init has no dependencies.\n","readmeTruncated":false}