> For the complete documentation index, see [llms.txt](https://star-generator.gitbook.io/star-generator-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://star-generator.gitbook.io/star-generator-docs/configuration/server-config.md).

# server config

Main config file:

```
plugins/StarGenerator/config.yml
```

## Table Entity Settings

```yaml
table-entity:
  spawn-y-offset: -0.5
  mythic-level: 1.0
  freeze-mythic-mobs: true
  lock-position: true
  startup-lock-ticks: 600
  duplicate-cleanup-radius: 0.75
  fallback-interaction:
    enabled: true
    range: 5.0
    horizontal-radius: 0.8
    height: 1.8
    y-offset: -0.25
  relink-radius: 16.0
  respawn-delay-ticks: 20
```

| Path                                                  | Description                                                                                                                   |
| ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| `table-entity.spawn-y-offset`                         | Vertical offset used when spawning table entities.                                                                            |
| `table-entity.mythic-level`                           | Level used when spawning MythicMobs table entities.                                                                           |
| `table-entity.freeze-mythic-mobs`                     | Freezes MythicMobs table entities at the table location.                                                                      |
| `table-entity.lock-position`                          | Locks table entities to their saved anchor location.                                                                          |
| `table-entity.startup-lock-ticks`                     | Number of ticks to repeatedly lock table entities during startup/reload while visual providers finish loading.                |
| `table-entity.duplicate-cleanup-radius`               | Radius used to remove duplicate table entities around the same anchor. Keep this small.                                       |
| `table-entity.fallback-interaction.enabled`           | Lets known tables open or break even when the visual model is missing, renamed, or does not fire provider interaction events. |
| `table-entity.fallback-interaction.range`             | Player raycast range for fallback table interaction.                                                                          |
| `table-entity.fallback-interaction.horizontal-radius` | Horizontal hitbox radius for fallback raycast detection.                                                                      |
| `table-entity.fallback-interaction.height`            | Fallback hitbox height.                                                                                                       |
| `table-entity.fallback-interaction.y-offset`          | Vertical offset applied to the fallback hitbox.                                                                               |
| `table-entity.relink-radius`                          | Search radius used to reconnect existing table entities after restart.                                                        |
| `table-entity.respawn-delay-ticks`                    | Delay before table entity respawn or refresh logic runs.                                                                      |

## Table Protection

```yaml
table-protection:
  owner-lock-open: true
  owner-lock-break: true
```

| Path                                | Description                                                  |
| ----------------------------------- | ------------------------------------------------------------ |
| `table-protection.owner-lock-open`  | Only the table owner can open owned tables unless bypassed.  |
| `table-protection.owner-lock-break` | Only the table owner can break owned tables unless bypassed. |

## Default Content

```yaml
default-content:
  enabled: true
```

Set `default-content.enabled` to `false` to stop StarGenerator from creating bundled starter packs, default groups, and provider resource files on startup/reload. Existing files are not deleted.

## Recipe Icon Default Detail

```yaml
recipe-icon:
  default-detail:
    enabled: true
    apply-when-lore-empty: true
    lore:
      - "&8Recipe Detail"
      - "&7Crafting Time: &f%crafting_time%"
      - "&7Energy Cost: &f%energy_cost%"
      - "&7Total Energy: &f%total_energy%"
```

This default lore is used by recipe icons when their `icon.lore` is empty. You can also insert it manually with `%default_detail%` or `{default_detail}`.

## Runtime Cache

```yaml
runtime-cache:
  backup-retention: 20
  purge-deleted-table-templates: true
  deleted-table-tombstones: true
  suspicious-drop-ratio: 0.10
```

| Path                                          | Description                                                                                                                                                |
| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `runtime-cache.backup-retention`              | Number of timestamped cache backups to keep per cache file.                                                                                                |
| `runtime-cache.purge-deleted-table-templates` | Removes cache and backup entries for table templates whose YAML files were intentionally deleted.                                                          |
| `runtime-cache.deleted-table-tombstones`      | Stores intentional table deletions so older backups cannot revive broken tables.                                                                           |
| `runtime-cache.suspicious-drop-ratio`         | If the primary cache restores far fewer tables than the last complete save, StarGenerator tries older backups first. Set `0.0` to disable the count guard. |

## Debug

```yaml
debug:
  recipe-loading: false
```

Keep `debug.recipe-loading` disabled on live servers. When enabled, StarGenerator logs each recipe file as it loads.

## Web Editor

```yaml
web-editor:
  bind: "127.0.0.1"
  allow-remote-bind: false
  port: 8787
  auto-increment-port: true
  port-scan-attempts: 20
  token-ttl-seconds: 900
  request-timeout-seconds: 10
  max-body-bytes: 524288
```

Keep `bind` on `127.0.0.1` unless you intentionally expose the editor. The editor link contains a token, but it should still be treated as an admin tool.

## Messages

Messages are configured under `message`.

Example:

```yaml
message:
  recipe-list-missing-items: "&cYou do not have enough items for this recipe."
  recipe-ingredient-give-permission: "&cYou do not have permission to give recipe ingredients."
  table-owner-open: "&cOnly the owner can open this table."
```


---

# 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:

```
GET https://star-generator.gitbook.io/star-generator-docs/configuration/server-config.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.