{"id":"nack-2/nametags","name":"nametags","scope":"nack-2","platform":"roblox","description":"Custom overhead nametags with a generic subtitle line.","version":"0.1.0","latest":"0.1.0","versions":["0.1.0"],"license":"MIT","licenseRating":"safe","licenseCaveats":["The package archive does not include its license text; the license is declared in its manifest metadata."],"licenseVerified":false,"dependencies":{},"integrity":"0b1b4baf73c719e22678a381f07eec634b9bf42117289a5776331ef1acab3e56","likes":0,"downloads":0,"install":"forest install nack-2/nametags","url":"https://forest.dev/p/roblox/nack-2/nametags","files":"https://api.forest.dev/ai/package/roblox/nack-2/nametags/files","readme":"# nametags\n\nCustom overhead nametags for Roblox (server realm).\n\nReplaces the default Humanoid name/health display with a `BillboardGui`\nshowing the player's `DisplayName` plus an optional subtitle line.\n\nThe subtitle line is generic: other systems own its content via\n`setSubtitle` (and `onTagCreated` to hook newly built tags).\nThis package has no knowledge of titles or any other system.\n\n## Install\n\nIn your game's server `wally.toml`:\n\n```toml\n[dependencies]\nnametags = \"nack-2/nametags@0.1.0\"\n```\n\nThen:\n\n```sh\nwally install --project-path ServerScriptService/Modules\n```\n\n## Usage\n\n```luau\nlocal NameTags = require(game.ServerScriptService.Modules.Packages.nametags)\n\nNameTags.setup() -- hooks all current and future players (safe to call multiple times)\n```\n\n## API\n\n- `setup()` — hook `Players.PlayerAdded` + all current players. Safe to call multiple times.\n- `setupPlayer(player)` — hook one player's respawns so every character gets the tag.\n- `setupCharacter(player, character)` — attach the tag to a specific character.\n- `getTag(player): BillboardGui?` — find a player's current tag, if any.\n- `setSubtitle(player, text, colour?)` — set the generic subtitle line; empty text hides it.\n- `onTagCreated(callback)` — hook fired with `(player, tag, character)` every time a tag is built.\n- `refresh(player)` — immediately re-render a player's `DisplayName`.\n\n## Publishing a new version\n\n1. Bump `version` in `wally.toml`.\n2. `wally package --project-path . --output nametags.zip` (or `--list` to preview files).\n3. `wally publish --project-path .`\n4. Add the new version to your wally index, then `wally install` in consuming projects.\n","readmeTruncated":false}