# Info Hub

**KyuubiSoft Info Hub gives players one book with everything about your server: news, rules, FAQ, the commands they may use, the team, server info, your own pages and quick tiles for common actions. Admins edit all of it in one admin window in the game.**

---

## How it works

- Players open the **Info Hub book** with `/ksinfo` (aliases `/hub`, `/hilfe`, `/menu`), a section shortcut such as `/rules` or `/faq`, or the Info Book item.
- The **Start** tab shows the server banner, the newest news, quick tiles and "Your books" (links to other installed KyuubiSoft books).
- Every section is a tab: **News, Rules, FAQ, Commands, Team, Server**, plus your **custom pages**, a **Search** and an "all tiles" view.
- Content lives in JSON files; every text can have translations per language. The [admin window](./admin-panel) edits all files with drafts, checks and backups.

---

## Features

| Section | What players see |
|---------|------------------|
| **News** | Announcements with type, date, expiry, pinned entries and links into the book; unread news are marked |
| **Rules** | Categories with severity chips (Notice / Warning / Mute-Kick / Ban), consequences and "changed" marks; optional rules acknowledgement |
| **FAQ** | Categories, accordion answers, command chips and "see also" links |
| **Commands** | The commands the player may use, by category, with description, usage, aliases, parameters, "To chat" and "Run" |
| **Team** | Ranks and members with avatar, online status, role and contact |
| **Server** | Description, address, live stats (online, record, uptime, total players, version, custom values) and links |
| **Custom pages** | TEXT, LIST, FAQ-style and GRID pages with simple markup and paging |
| **Search** | Across rules, FAQ, commands, news, custom pages and (optionally) team; a hit opens exactly its entry |
| **Quick tiles** | Buttons that run a command as the player, send a link, ask for values or jump inside the book |

More:

- **9 languages** for the interface, and optional translations for every piece of content.
- **Info Book item**, a **join message** (per language), optional **first-join book** and an optional **news hint** after join.
- Works **without KyuubiSoft Core**. With Core you also get the `/ksadmin` hub tile, the shared settings window and the web editor.

---

## What's new in 3.x

- **2.10.8 - security hotfix.** Quick-access buttons no longer send their command to the client; the server looks every click up and checks it again. Update from older versions.
- **3.0.0 - Info Hub book.** One window replaces the old overlay with its two sidebars and the 13 separate pages. New: news with read state, rules acknowledgement (off by default), first-join book, news hint, per-language content, search that opens the exact entry, quick tiles that can jump inside the book, "Your books".
- **3.0.1 / 3.0.2** - Language system of KyuubiSoft Core 2.8.0, clean shutdown, readable news hint.
- **3.1.0 - new admin window.** One window replaces the old admin panel: content boards for news, rules, FAQ, pages, tiles, team and server, settings boards, texts per language, a check view with about 50 rules, merge on conflicts, backups and **Undo last save**.
- **3.1.1 - playtest fix.** The item picker of the admin window opens as a framed window over a dimmed backdrop.

:::note
The 3.x windows have not been tested in game yet.
:::

See the [Changelog](./changelog) for the full list.

---

## Commands

| Command | Aliases | Description | Permission |
|---------|---------|-------------|------------|
| `/ksinfo` | `/hub`, `/hilfe`, `/menu` | Opens the Info Hub book | `ks.info.user.use` (granted by default) |
| `/rules`, `/faq`, `/commands`, `/team` | configurable | Open the book on that section | `ks.info.user.use` + the section's own permission |
| `/ksinfoitem` | `/getinfo`, `/infobuch` | Gives you the Info Book item | `ks.info.user.use` |
| `/ksinfoadmin panel` | | Opens the admin window | `ks.info.admin` |
| `/ksinfoadmin reload` | | Reloads all files | `ks.info.admin` (or the console) |
| `/ksinfoadmin browsebanners` | | Lists the banner files in chat | `ks.info.admin` |

The main command, its aliases and the section shortcuts are set in `config.json`. `help` is never registered (the game's `/help` always wins). See [Commands](./commands) and [Permissions](./permissions).

---

## Files

```
mods/kyuubisoft_infohub/
├── config.json                    # main settings, sections, join message, book links
├── commands/categories.json       # command categories, filters, execution
├── rules/rules.json               # rules
├── faq/faq.json                   # FAQ
├── serverinfo/serverinfo.json     # server info, links, stats, news
├── team/team.json                 # ranks and members
├── quickaccess/quickaccess.json   # quick tiles
├── custom/pages.json              # custom pages
├── banner/                        # server banner image (PNG, max 1520 x 240)
├── state/server_state.json        # rule versions, online record
└── localization/                  # 9 languages + custom_<lang>.json
```

---

## Quick Reference

| Item | Details |
|------|---------|
| **Plugin** | KyuubiSoft Info Hub (manifest `kyuubisoft:infohub`) |
| **Version** | 3.1.1 (2026-10-28) |
| **Jar** | `KyuubiSoftInfoHub-3.1.1.jar` |
| **Data folder** | `mods/kyuubisoft_infohub/` |
| **Localization** | 9 languages, version 13 |
| **Required** | nothing |
| **Optional** | KyuubiSoft Core (admin hub tile, `/kssettings`, web editor, NPCs) |

## Requirements

- Hytale server 0.7.x (built against 0.7.0)
- Java 25
- KyuubiSoft Core is optional. With Core older than 2.9.2 the web editor cannot change console tiles.

## Download

[![CurseForge](https://img.shields.io/badge/CurseForge-Download-orange?style=for-the-badge&logo=curseforge)](https://www.curseforge.com/hytale/mods/kyuubisoft-info-hub-commands-faq-team-own-item)

## Support

- **Discord**: [KyuubiSoft Discord](https://dc.gg/kyuubisoft)