Permissions

Práva pluginu

kit.use - právo pro hráče, pokud v configu zapneš vyžadování permission.
kit.admin - právo pro administrátora, který může otevřít editor, upravovat kity a defaultně ignoruje limity.

Plugin je defaultně nastavený tak, že každý hráč může použít /kit a /kits. Pokud chceš menu jen pro určitou skupinu, zapni v configu Require player use permission a dej skupině kit.use.

Popis

Co plugin obsahuje

Hráčské menu kitů s obrázkem, cenou, stavem dostupnosti a tlačítkem Inspect.
Admin editor přímo ve hře pro název, barvu názvu, popis, obrázek, cenu a cooldowny.
Cooldown po použití, wipe cooldown po novém wipe a limit použití na hráče.
Podpora skupin/ranků přes Oxide groups, v editoru se dají skupiny zapínat a vypínat.
Kopírování itemů z aktuálního inventáře administrátora do kitu.
Inspect okno s rozložením inventáře podobným Rustu: inventory, hotbar a oblečení.
Podpora ceny za kit přes Scrap, Economics nebo Server Rewards.
Prázdné menu se otevře i bez vytvořených kitů, takže admin může začít přes UI.

Kompatibilita

Volitelné napojení

Plugin běží i bez dalších pluginů. Pokud jsou na serveru dostupné, umí využít tyto integrace:

Image Library - cache obrázků kitů z URL.
Human NPC - otevření konkrétní nabídky kitů přes NPC.
Player DLC API - filtrování placených skinů podle vlastnictví hráče.
No Escape - blokace claimnutí během raid/combat blocku.
Economics - cena kitu přes Economics balance.
Server Rewards - cena kitu přes reward points.

Config

Nastavení po instalaci

Po nahrání do oxide/plugins/Kits.cs se vytvoří oxide/config/Kits.json. Config nemusíš ručně upravovat, pokud si vše nastavíš přes herní editor. Ruční editace je jen pro majitele, kteří chtějí plugin spravovat souborově.

Položka	Co znamená
`Chat prefix`	Prefix zpráv v chatu.
`Kit chat command`	Hlavní příkaz pro otevření menu. Default je `kit`, funguje i `/kits`.
`Admin permission`	Permission pro editaci kitů. Default `kit.admin`.
`Player use permission`	Permission pro hráče. Default `kit.use`.
`Require player use permission`	Když je `false`, hráči mohou používat menu bez grantování permission. Když je `true`, musí mít `kit.use`.
`Drop overflowing items on ground`	Když hráč nemá místo, přebytečné itemy spadnou na zem místo blokace kitu.
`Use the Kits UI menu`	Zapne grafické menu. Pokud vypneš, plugin používá textový seznam v chatu.
`Players with the admin permission ignore usage restrictions`	Admin s `kit.admin` defaultně ignoruje cooldown, cenu, ranky, use limit i inventory blokace.
`Wipe player data when the server is wiped`	Po novém wipe smaže cooldowny a počty použití.
`Currency used for purchase costs`	Měna pro cenu kitu: `Scrap`, `Economics` nebo `ServerRewards`.
`Log kits given`	Zapne logování vydaných kitů do souboru.
`Use Player DLC API to remove unowned paid skins`	Pokud je dostupný Player DLC API, plugin může odstranit nebo nahradit skiny, které hráč nevlastní.
`Allow players to toggle auto-kits on spawn`	Dovolí hráčům vypnout/zapnout autokity po spawnu.
`Autokits ordered by priority`	Seznam kitů, které se zkouší dát hráči po spawnu.
`UI Options`	Barvy panelů, accent barvy a defaultní URL obrázku kitu.
`Kit menu items when opened via HumanNPC`	Nastavení, které kity otevře konkrétní NPC podle jeho user ID.
`Kits`	Všechny vytvořené kity. Čistá instalace je prázdná, kity si vytvoříš přes editor nebo config.

{
  "Chat prefix": "<color=#54c7ff><b>Kits</b></color>",
  "Kit chat command": "kit",
  "Admin permission": "kit.admin",
  "Player use permission": "kit.use",
  "Require player use permission": false,
  "Drop overflowing items on ground": true,
  "Use the Kits UI menu": true,
  "Players with the admin permission ignore usage restrictions": true,
  "Wipe player data when the server is wiped": true,
  "Currency used for purchase costs (Scrap, Economics, ServerRewards)": "Scrap",
  "Log kits given": false,
  "Use Player DLC API to remove unowned paid skins": true,
  "Allow players to toggle auto-kits on spawn": false,
  "Autokits ordered by priority": [],
  "UI Options": {
    "Panel color": "0.015 0.016 0.020 0.97",
    "Header color": "0.060 0.063 0.073 1",
    "Accent color": "0.18 0.56 0.80 0.98",
    "Success color": "0.28 0.58 0.22 0.98",
    "Danger color": "0.72 0.07 0.055 0.98",
    "Default kit image URL": "https://chaoscode.io/oxide/Images/kiticon.png"
  },
  "Kit menu items when opened via HumanNPC (NPC user ID | Items)": {},
  "Kits": {}
}