other support

---

Support & Contact

Before Reporting a Bug

If 1 or more fail → fix what it says before opening a ticket.

Official Channels

Channel	URL	Response Time
🟢 Discord (recommended)	https://discord.com/invite/SfKvR4CbUj	24–72h
🟡 Modrinth Issues	https://modrinth.com/plugin/vault-2.0-economy-plugins	3–7 days
🔴 GitHub Issues	https://github.com/shalom25/Vault2.0	Technical bug reports

Which Channel to Use?

• Usage questions, configuration, skripts, placeholders → Discord #support
• Reproducible bugs + crash logs → Modrinth Issues
• Pull request / code / architecture → GitHub Issues

---

Reporting a Bug (Modrinth / GitHub)

Use this template so we can help you quickly:

### Versions
- Vault: `2.1.0` (put exact build)
- Build: `legacy` (Java 17) / `modern` (Java 21)
- Server: Paper `1.20.4` (put your fork and build)
- Java: `OpenJDK 17.0.11`
- Relevant dependencies:
  - LuckPerms `5.4.102`
  - PlaceholderAPI `2.11.5`
  - SkinsRestorer `15.0.3`
  - Skript `2.8.0`
  - (others)

### Affected Configuration
```yaml
# Paste the relevant section from config.yml
storage:
  use_mysql: true
  ...
hmac:
  ...

Steps to Reproduce

1. /vault note issue 1000 coins
2. Close and open inventory
3. Right-click the note → crash

Expected Behavior

The note should redeem and add 1000 to the balance.

Actual Behavior

[ERROR] Could not pass event PlayerInteractEvent to Vault v2.1.0
org.bukkit.event.EventException: null
  at org.bukkit.plugin.java.JavaPluginLoader$1.execute(JavaPluginLoader.java:310) ~[?:?]
Caused by: net.milkbowl.vault.services.HMACValidationException
  at ...

Attachments

• Full latest.log (not trimmed)
• Full config.yml (hide passwords)
• Screenshot if GUI / visual issue

---

## Report Template (Discord)

Paste this in `#support`:

Platform: Paper 1.20.1 Vault: 2.1.0 legacy Java: 17 Dependencies: LuckPerms, PlaceholderAPI, Skript

Problem:

[Vault] HMAC lore mismatch 5 fields vs 3

Already tried:

• Troubleshooting §1 → did migrate but it fails

Logs: https://paste.gg/...

---

## SLA and Response Times

| Issue | Priority | Response SLA |
|---|---|---|
| Crash / data loss | 🔴 P0 | < 8 business hours |
| Invalid note / dupe | 🟠 P1 | < 24h |
| Inconsistent balance | 🟠 P1 | < 24h |
| Placeholder not working | 🟡 P2 | 3–5 days |
| Missing translation | 🟢 P3 | Weekly |
| Feature request | 🔵 Backlog | Sprint to sprint |

---

## Frequently Asked Questions

**Is Vault 2.0 compatible with Vault 1.x plugins?**
Yes. `VaultPlugin.getEconomyProvider()` returns the legacy `Economy` interface and the modern `SimpleEconomy`. Your plugins won't notice the change.

**Can I change `hmac.secret` without breaking notes?**
Yes, use `previous_secret` and `migration: true` for 30 days (Changelog / Contribute).

**Does Vault touch the old net.milkbowl.vault packages?**
Yes, they are kept for binary compatibility, but new code goes under `net.milkbowl.vault.*`.

---

## Security Disclosures (Critical)

If you find a critical flaw (duplicate notes, HMAC bypass, SQL injection, remote execution): **DO NOT** open a public issue.

Send an email to:

security [at] vault-economy.dev

with the PGP key fingerprint published in the README. Include step-by-step reproduction and a patch if you have one.

Response time **72h** for critical issues.