> For the complete documentation index, see [llms.txt](https://b-setups.gitbook.io/b.-setups/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://b-setups.gitbook.io/b.-setups/servers/block-party-server/additional-information/where-to-find-what.md).

# Where to Find What

This guide provides a breakdown of where to find the essential configurations, language files, menus, scripts, and customizable texts for **Block Party Server Setup**. Use this reference to translate the server, change items, or adjust the server's visual presentation.

***

### **1. Core Game Messages & Translation**

*These files and folders control the primary in-game text, including chat messages, game states, arena messages, and basic item names related to the main game mode.*

* **Main Plugin Folder:** `plugins/BlockParty/`
  * **Configuration:** `plugins/BlockParty/config.yml` controls global Block Party settings, join signs, lobby behavior, rewards, and enabled features.
  * **Locale:** `plugins/BlockParty/Locale/locale_en.yml` controls the main Block Party messages, command texts, scoreboard lines, signs, and MOTD texts used by the BlockParty plugin.
  * **Arenas:** `plugins/BlockParty/Arenas/` contains the arena configuration files.
  * **Floors:** `plugins/BlockParty/Floors/` contains floor and pattern-related files.
  * **Songs:** `plugins/BlockParty/Songs/` contains the Block Party song files.

### **2. Scoreboard & Tablist**

*These settings dictate the UI elements shown on the right side of the screen (Scoreboard) and when holding the TAB key (Player list and server info).*

* **TAB Plugin:** `plugins/TAB/config.yml`
  * Open this file to translate or modify the scoreboard title, the lines displayed on the side, header/footer texts in the player list, and nametag prefixes.
  * Block Party stats on the lobby scoreboard are displayed through PlaceholderAPI placeholders, so changes to the BlockParty placeholders may also affect the scoreboard output.

### **3. MOTD & Server List Appearance**

*The MOTD (Message of the Day) is the text players see in their multiplayer server list before they connect to the server. It also includes the hover text over the player count.*

* **AdvancedServerList:** `plugins/AdvancedServerList/profiles/default.yml`
  * Here you can translate the two lines of text displayed under the server name in the multiplayer menu, and adjust the favicon and player-count hover.

### **4. Custom Scripts & Action Texts**

*Skript is used for setup-specific commands, announcements, lobby aliases, join behavior, and plugin hiding.*

* **Skript Folder:** `plugins/Skript/scripts/`
  * `main_commands.sk` controls `/help`, `/store`, and `/discord` messages.
  * `announce.sk` controls automatic announcement messages and `/announcements`.
  * `lobby_aliases.sk` controls `/l`, `/lobby`, and `/hub`.
  * `onjoin.sk` controls join behavior.
  * `pluginhider.sk` controls hidden plugin command responses.
  * `startup.sk` controls the first-run setup restart flow.
  * Open these files and translate the texts between quotation marks `" "`.

### **5. Arena Selector & Leaderboards**

*The setup includes a custom companion plugin for lobby arena selection and Block Party leaderboard holograms.*

* **BlockPartyAdditions:** `plugins/BlockPartyAdditions/config.yml`
  * Controls the lobby arena selector item, `/arenas` menu title, menu size, item slots, item materials, lore, and all selector colors.
  * Controls lobby void teleport when players fall below the configured Y level.
  * Controls the hologram text design, leaderboard row format, no-data text, refresh timing, and available hologram types.
* **BlockPartyAdditions Holograms:** `plugins/BlockPartyAdditions/holograms.yml`
  * Stores the placed leaderboard holograms by ID, type, world, coordinates, yaw, and pitch.
  * Use `/bpholo add <type>` to create a hologram where you stand, `/bpholo remove <id>` to delete one, and `/bpholo list` to see all IDs.
  * The leaderboard data is read from the BlockParty statistics database, so no separate hologram plugin is required.
* **Native BlockParty Patch:** `plugins/BlockParty main.jar`
  * The Leave Arena item, Vote for a Song item, 45-slot Song Vote menu, clean song titles, countdown sound fallback, and winner fireworks are patched directly into the BlockParty plugin.
  * These native item changes are not controlled by BlockPartyAdditions, so BlockParty can give and remove the correct items during arena join and game start.

### **6. Party System**

*The setup includes Parties so players can group up and play together.*

* **Parties Main Config:** `plugins/Parties/config.yml`
  * Controls the party command system, auto-command behavior, command aliases, and debug logging.
  * The auto-command system repeats whitelisted Block Party join commands from the party leader to party members.
* **Parties Messages:** `plugins/Parties/messages.yml`
  * Controls party command messages, hover texts, help lines, and party chat formatting.

### **7. Global Server Messages**

*These handle basic server functions like unknown commands, joining, quitting, and core economy texts.*

* **EssentialsX:** `plugins/Essentials/`
  * If you need to translate standard commands like `/tp`, `/msg`, or economy messages, look for the `messages_en.properties` file here (you might need to extract it from the Essentials jar if it's not generated).
  * The setup uses Essentials economy through Vault where economy placeholders or other plugins need a balance provider.
* **Server / Spigot messages:** `spigot.yml`
  * The whitelist, unknown-command, server-full, outdated-client/server and restart messages are set here.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://b-setups.gitbook.io/b.-setups/servers/block-party-server/additional-information/where-to-find-what.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
