> For the complete documentation index, see [llms.txt](https://docs.cheddah-development.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cheddah-development.net/plugin-documentaion/cozy-claims/troubleshooting.md).

# Troubleshooting

## Troubleshooting

### CozyClaims does not enable

1. Confirm the server is Paper 26.2.
2. Confirm the server is running Java 25.
3. Read the first CozyClaims error in the console, not only the final disable message.
4. Confirm the server had internet access on first startup so Paper could download SQLite JDBC.
5. Confirm only one CozyClaims JAR is present in `plugins`.

### Claims or protection are unavailable

* Check that the world is not listed under `disabled-worlds`.
* Confirm `plugins/CozyClaims/claims.db` exists and is writable.
* Look for database startup errors in the console.
* On migrated installations, run `/claimsadmin removalcheck` and confirm the authority/cutover state.

### A player cannot create or expand a claim

* Open the Claim Blocks menu and confirm enough blocks are ready to use.
* Ensure both selection corners are in the same world.
* Ensure the selection does not overlap any existing claim area.
* Ensure the world is not disabled.
* For imported legacy claims, convert the claim before native Add Land or resize operations.

Failed create or Add Land attempts intentionally leave Claim Mode active so the selection can be corrected.

### A member still cannot perform an action

* Confirm their current role in the claim's Members menu.
* Check the related Claim Setting. A role and a claim-wide setting can both affect access.
* Confirm the player is in the expected logical claim area.
* Check whether the player is banned from the claim.

### Teleportation fails

* Confirm `teleport.enabled` is true.
* Check `cozyclaims.teleport`.
* Check the cooldown, cross-world, and claim-access settings.
* Confirm the claim's primary-area world is loaded.
* CozyClaims refuses the teleport if it cannot find a safe destination.

### Borders are not visible

* Confirm `borders.enabled` and `borders.blocks.enabled` are true.
* Check `cozyclaims.borders`.
* Ensure configured edge and corner materials are valid blocks.
* Particles are optional; fake block borders can still work when particles are disabled.

### Configuration changes do not appear

* Validate YAML indentation and spacing.
* Run `/claimsadmin reload`.
* Check the console for invalid material, sound, or YAML warnings.
* Restart after changing the JAR or diagnosing startup/library issues.

### Safe recovery

Before experimenting with data recovery:

1. Stop the server.
2. Back up the entire `plugins/CozyClaims` folder.
3. Work on a copy.
4. Do not edit `claims.db` manually.


---

# 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://docs.cheddah-development.net/plugin-documentaion/cozy-claims/troubleshooting.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.