{"url":"https://levimc.org/mods/github.com/LordBombardir/LLPlaceholderApi/","tooth":"github.com/LordBombardir/LLPlaceholderApi","name":"PlaceholderApi","description":"This mod is intended for developers who want to support multilingualism.","owner":"LordBombardir","icon":"https://avatars.githubusercontent.com/LordBombardir?s=144","repository":"https://github.com/LordBombardir/LLPlaceholderApi","issues":"https://github.com/LordBombardir/LLPlaceholderApi/issues","releases":"https://github.com/LordBombardir/LLPlaceholderApi/releases","stars":0,"updated":"2026-07-10T13:43:01Z","published":"2026-02-01T08:10:18Z","created":"2026-01-20T09:32:49Z","license":"CC0-1.0","categories":[],"platforms":["levilamina"],"env":["server","client"],"gameVersions":["1.26.20","1.26.10","1.21.132"],"tags":["platform:levilamina","type:mod"],"latest":{"variant":"","version":"26.20.2","install":"lip install github.com/LordBombardir/LLPlaceholderApi@26.20.2"},"readmes":[{"file":"README.md","lang":"en","text":"# PlaceholderApi\n\nA Minecraft Bedrock server mod for LeviLamina that helps developers support multilingualism in their mods. It intercepts outbound packets (like text messages, titles, toast requests, actor names, and forms) and replaces custom placeholders with locale-specific translations before the packets reach the clients.\n\n## How it works\n\nThe API generates a unique placeholder key based on an identifier. You register translations for different locales under this key. When the server sends a packet containing the key, the mod detects the recipient's language, matches it with your registered translations, and sends the localized packet to that player.\n\n## Usage (C++ API)\n\nInclude `<placeholder_api/Api.h>` in your project.\n\n### 1. Persistent Placeholders\n\n```cpp\n#include <placeholder_api/Api.h>\n\n// 1. Generate a key (e.g. \"my_prefix:some_hash\")\nstd::string key = placeholder::api::generatePlaceholder(\"my_mod.welcome_message\");\n\n// 2. Set translations for different locales\nplaceholder::api::setPlaceholder(key, \"Welcome to the server!\", \"en_US\");\nplaceholder::api::setPlaceholder(key, \"Добро пожаловать на сервер!\", \"ru_RU\");\n\n// 3. Use the generated key in any packet (e.g. chat messages, titles, forms)\nplayer.sendMessage(key);\n```\n\n### 2. Temporary Placeholders\n\nUseful for temporary values (like UI status or short-lived text) that you want cleaned up automatically.\n\n```cpp\nstd::string tempKey = placeholder::api::generateTemporaryPlaceholder();\n\nplaceholder::api::setTemporaryPlaceholder(tempKey, \"Active\", \"en_US\");\nplaceholder::api::setTemporaryPlaceholder(tempKey, \"Активен\", \"ru_RU\");\n```\n\n## Supported Packets\n\nThe mod automatically scans and replaces placeholders in:\n- `TextPacket` (messages)\n- `SetTitlePacket` (titles/subtitles)\n- `ToastRequestPacket` (toast notifications)\n- `ModalFormRequestPacket` (custom form JSONs)\n- `AvailableCommandsPacket` (command descriptions)\n- `AddPlayerPacket` & `AddActorPacket` & `SetActorDataPacket` (actor metadata/name tags)\n"}],"gallery":[],"variants":[{"label":"","versions":["26.20.2","26.20.1","26.20.0","26.10.1","1.0.2","1.0.1","1.0.0"]},{"label":"client","versions":["26.20.2","26.20.1","26.20.0","26.10.1","1.0.2","1.0.1","1.0.0"]}],"versions":[{"version":"26.20.2","prerelease":false,"released":"2026-07-10T13:43:01Z","releaseUrl":"https://github.com/LordBombardir/LLPlaceholderApi/releases/tag/v26.20.2","manifestUrl":"https://github.com/LordBombardir/LLPlaceholderApi/blob/v26.20.2/tooth.json","info":{"name":"PlaceholderApi","description":"This mod is intended for developers who want to support multilingualism.","tags":["platform:levilamina","type:mod"],"avatar_url":""},"variants":[{"label":"","platform":"win-x64","dependencies":{"github.com/LiteLDev/LeviLamina":">=26.20.*"},"leviLamina":">=26.20.*","install":"lip install github.com/LordBombardir/LLPlaceholderApi@26.20.2"},{"label":"client","platform":"win-x64","dependencies":{"github.com/LiteLDev/LeviLamina#client":">=26.20.*"},"leviLamina":">=26.20.*","install":"lip install github.com/LordBombardir/LLPlaceholderApi#client@26.20.2"}]},{"version":"26.20.1","prerelease":false,"released":"2026-07-09T16:36:40Z","releaseUrl":"https://github.com/LordBombardir/LLPlaceholderApi/releases/tag/v26.20.1","manifestUrl":"https://github.com/LordBombardir/LLPlaceholderApi/blob/v26.20.1/tooth.json","info":{"name":"PlaceholderApi","description":"This mod is intended for developers who want to support multilingualism.","tags":["platform:levilamina","type:mod"],"avatar_url":""},"variants":[{"label":"","platform":"win-x64","dependencies":{"github.com/LiteLDev/LeviLamina":">=26.20.*"},"leviLamina":">=26.20.*","install":"lip install github.com/LordBombardir/LLPlaceholderApi@26.20.1"},{"label":"client","platform":"win-x64","dependencies":{"github.com/LiteLDev/LeviLamina#client":">=26.20.*"},"leviLamina":">=26.20.*","install":"lip install github.com/LordBombardir/LLPlaceholderApi#client@26.20.1"}]},{"version":"26.20.0","prerelease":false,"released":"2026-07-07T10:33:12Z","releaseUrl":"https://github.com/LordBombardir/LLPlaceholderApi/releases/tag/v26.20.0","manifestUrl":"https://github.com/LordBombardir/LLPlaceholderApi/blob/v26.20.0/tooth.json","info":{"name":"PlaceholderApi","description":"This mod is intended for developers who want to support multilingualism.","tags":["platform:levilamina","type:mod"],"avatar_url":""},"variants":[{"label":"","platform":"win-x64","dependencies":{"github.com/LiteLDev/LeviLamina":">=26.20.*"},"leviLamina":">=26.20.*","install":"lip install github.com/LordBombardir/LLPlaceholderApi@26.20.0"},{"label":"client","platform":"win-x64","dependencies":{"github.com/LiteLDev/LeviLamina#client":">=26.20.*"},"leviLamina":">=26.20.*","install":"lip install github.com/LordBombardir/LLPlaceholderApi#client@26.20.0"}]},{"version":"26.10.1","prerelease":false,"released":"2026-04-12T15:17:00Z","releaseUrl":"https://github.com/LordBombardir/LLPlaceholderApi/releases/tag/v26.10.1","manifestUrl":"https://github.com/LordBombardir/LLPlaceholderApi/blob/v26.10.1/tooth.json","info":{"name":"PlaceholderApi","description":"This mod is intended for developers who want to support multilingualism.","tags":["platform:levilamina","type:mod"],"avatar_url":""},"variants":[{"label":"","platform":"win-x64","dependencies":{"github.com/LiteLDev/LeviLamina":">=26.10.*"},"leviLamina":">=26.10.*","install":"lip install github.com/LordBombardir/LLPlaceholderApi@26.10.1"},{"label":"client","platform":"win-x64","dependencies":{"github.com/LiteLDev/LeviLamina#client":">=26.10.*"},"leviLamina":">=26.10.*","install":"lip install github.com/LordBombardir/LLPlaceholderApi#client@26.10.1"}]},{"version":"1.0.2","prerelease":false,"released":"2026-05-09T09:02:57Z","releaseUrl":"https://github.com/LordBombardir/LLPlaceholderApi/releases/tag/v1.0.2","manifestUrl":"https://github.com/LordBombardir/LLPlaceholderApi/blob/v1.0.2/tooth.json","info":{"name":"PlaceholderApi","description":"This mod is intended for developers who want to support multilingualism.","tags":["platform:levilamina","type:mod"],"avatar_url":""},"variants":[{"label":"","platform":"win-x64","dependencies":{"github.com/LiteLDev/LeviLamina":">=1.9.*"},"leviLamina":">=1.9.*","install":"lip install github.com/LordBombardir/LLPlaceholderApi@1.0.2"},{"label":"client","platform":"win-x64","dependencies":{"github.com/LiteLDev/LeviLamina#client":">=1.9.*"},"leviLamina":">=1.9.*","install":"lip install github.com/LordBombardir/LLPlaceholderApi#client@1.0.2"}]},{"version":"1.0.1","prerelease":false,"released":"2026-02-04T09:44:23Z","releaseUrl":"https://github.com/LordBombardir/LLPlaceholderApi/releases/tag/v1.0.1","manifestUrl":"https://github.com/LordBombardir/LLPlaceholderApi/blob/v1.0.1/tooth.json","info":{"name":"PlaceholderApi","description":"This mod is intended for developers who want to support multilingualism.","tags":["platform:levilamina","type:mod"],"avatar_url":""},"variants":[{"label":"","platform":"win-x64","dependencies":{"github.com/LiteLDev/LeviLamina":">=1.9.*"},"leviLamina":">=1.9.*","install":"lip install github.com/LordBombardir/LLPlaceholderApi@1.0.1"},{"label":"client","platform":"win-x64","dependencies":{"github.com/LiteLDev/LeviLamina#client":">=1.9.*"},"leviLamina":">=1.9.*","install":"lip install github.com/LordBombardir/LLPlaceholderApi#client@1.0.1"}]},{"version":"1.0.0","prerelease":false,"released":"2026-02-01T08:10:18Z","releaseUrl":"https://github.com/LordBombardir/LLPlaceholderApi/releases/tag/v1.0.0","manifestUrl":"https://github.com/LordBombardir/LLPlaceholderApi/blob/v1.0.0/tooth.json","info":{"name":"PlaceholderApi","description":"This mod is intended for developers who want to support multilingualism.","tags":["platform:levilamina","type:mod"],"avatar_url":""},"variants":[{"label":"","platform":"win-x64","dependencies":{"github.com/LiteLDev/LeviLamina":">=1.9.*"},"leviLamina":">=1.9.*","install":"lip install github.com/LordBombardir/LLPlaceholderApi@1.0.0"},{"label":"client","platform":"win-x64","dependencies":{"github.com/LiteLDev/LeviLamina#client":">=1.9.*"},"leviLamina":">=1.9.*","install":"lip install github.com/LordBombardir/LLPlaceholderApi#client@1.0.0"}]}],"dependencies":{"github.com/liteldev/levilamina":{"tooth":"github.com/LiteLDev/LeviLamina","name":"LeviLamina","owner":"LiteLDev","url":"https://levimc.org/mods/github.com/LiteLDev/LeviLamina/"}},"requiredBy":[{"tooth":"github.com/LordBombardir/LLPowerRanks","name":"PowerRanks","owner":"LordBombardir","url":"https://levimc.org/mods/github.com/LordBombardir/LLPowerRanks/"},{"tooth":"github.com/LordBombardir/LLStructureLoader","name":"StructureLoader","owner":"LordBombardir","url":"https://levimc.org/mods/github.com/LordBombardir/LLStructureLoader/"}]}