🌍 Language	🧠 Completion & Badge	🧑‍💻 Contributor(s)	📄 File
🌐 English (Base) — en	[##########] 100.0%	@tobydeteckel	en.json
🇩🇪 German — de	[----------] 1.3%	Open for contributors!	de.json
🇪🇸 Spanish — es	[----------] 0.0%	Open for contributors!	es.json
🇫🇷 French — fr	[#########-] 88.6%	@mbiork, H4wKs	fr.json
🇵🇹 Portuguese — pt	[----------] 0.0%	Open for contributors!	pt.json

📘 SquadStatsBot Translations

This repository contains language files for the SquadStats Discord Bot. These files allow the bot to support multiple languages, making it more accessible and user-friendly around the world.

---

All translation files are stored in the locales/ folder.

• en.json: Is the base file, English (default and reference).
• fr.json, de.json, etc.: Other language files.

Each file is a JSON object structured by category and string key:

{
  "serverstats": {
    "1": {
      "default": "Server kill Stats",
      "translated": "Statistiques de kill serveur"
    }
  }
}

• default: The original English text (always from en.json) (will also function as fallback value.)
• translated: The translated version in the target language

⚠️ Never change default fields in translation files. These are automatically synced.

---

🌍 Adding a New Language

Want to help translate the bot into your language? Great!

🔹 Step 1: Request the Language

Before adding a new language yourself, please open an issue or discussion in this repository titled: "Request: Add [Your Language Name]"

This lets the maintainer:

• Add an official entry for your language
• Generate a proper template file with all required keys
• Ensure consistency with the sync system

🔹 Step 2: Translate

Once your language file is availible (e.g., locales/fr.json for French or locales/de.json for Deutsch/German), you can:

• Open it
• Fill in the "translated" values
• Leave "default" values unchanged, those fields also function as fallback value in case the "translated" field is not set.

🔹 Step 3: Submit a Pull Request

When you're ready, create a PR with:

• Title: Add Spanish translations or Update Turkish translations
• Description: What you translated or improved

---

🔁 Syncing

Whenever the English file (en.json) is updated by the maintainer, the translation files will also be updated to:

• Adds any new keys
• Ensure default values stay in sync
• Remove unused entries (if deleted from en.json)

⚠️ You don't need to manually manage structure or categories — just translate the translated fields.

---

🧪 Testing Your Edits

You can use any JSON linter (like jsonlint.com) to verify your files.

Make sure:

• Your file is valid JSON
• Every object has both default and translated keys

---

🙌 Contributing

Everyone is welcome to contribute translations!

🛠 Rules

• Do not modify the default translation file, en.json
• Do not change default values in translation files
• Use the existing key structure and format

✅ Checklist Before PR

• Only edited translated fields
• File is valid JSON
• Language file was pre-generated (not manually created)

If you're unsure about something — open an issue and ask!

---

📬 Contact

Maintained by @Tobydeteckel

If you have any suggestions, improvements, or run into issues, feel free to open a GitHub Issue or contact our discord @ squadstats.nl/discord

---

Thank you for helping make SquadStats better for everyone! 🌍💬