StarT Translations Manager

A comprehensive translation management system for the Star Technology Minecraft modpack.

Installation

1. Clone this repository or download the files
2. Ensure you have Python 3.7+ installed
3. Install required dependencies:

   pip install tkinter

   Note: tkinter usually comes with Python by default

Usage

GUI Application

Launch the graphical interface:

python launch_gui.py

Main Features:

1. Open Workspace: Load your translation files from the lang folder
2. Language Selection: Choose which language to work on
3. Category Filtering: Filter by mod categories and subcategories
4. Translation Editor: Edit translations with real-time formatting preview
5. Formatting Tools: Add Minecraft color codes and formatting
6. Search: Find specific translations quickly
7. Statistics: View translation progress

Keyboard Shortcuts:

• Ctrl+O: Open workspace
• Ctrl+S: Save all translations
• Ctrl+F: Focus search
• F5: Refresh translations

Command Line Interface

Launch the CLI tool:

python launch_cli.py <workspace_path> <command>

Available Commands:

# List available languages
python launch_cli.py lang list-languages

# List categories
python launch_cli.py lang list-categories

# Add a new language
python launch_cli.py lang add-language fr_fr

# Validate translations
python launch_cli.py lang validate es_es

# Export untranslated keys
python launch_cli.py lang export-untranslated es_es untranslated_es.txt

# Show statistics
python launch_cli.py lang stats es_es

File Structure

StarT-Translations/
├── src/                          # Source code
│   ├── translation_manager.py    # Core translation logic
│   ├── translation_gui.py        # GUI application
│   └── translation_cli.py        # CLI tool
├── lang/                         # Translation files
│   ├── core-mod/
│   │   └── en_us.json           # English (base language)
│   ├── gtceu/
│   └── ...
├── launch_gui.py                 # GUI launcher
├── launch_cli.py                 # CLI launcher
└── README.md                     # This file

Adding New Languages

Using the GUI:

1. Click "Add Language" in the toolbar
2. Enter the language code (e.g., fr_fr, de_de)
3. All translation keys will be created automatically with empty values

Using the CLI:

python launch_cli.py lang add-language fr_fr

Supported Language Codes:

Use standard Minecraft language codes:

• es_es - Spanish (Spain)
• fr_fr - French (France)
• de_de - German (Germany)
• pt_br - Portuguese (Brazil)
• ru_ru - Russian
• zh_cn - Chinese (Simplified)
• ja_jp - Japanese
• And many more...

Minecraft Formatting

The tool supports all Minecraft formatting codes:

Color Codes:

• §0 - Black
• §1 - Dark Blue
• §2 - Dark Green
• §3 - Dark Aqua
• §4 - Dark Red
• §5 - Dark Purple
• §6 - Gold
• §7 - Gray
• §8 - Dark Gray
• §9 - Blue
• §a - Green
• §b - Aqua
• §c - Red
• §d - Light Purple
• §e - Yellow
• §f - White

Formatting Codes:

• §l - Bold
• §o - Italic
• §n - Underline
• §m - Strikethrough
• §k - Obfuscated
• §r - Reset

Example:

§6Gold text §l§cBold Red §rNormal text

Translation Guidelines

DO:

• ✅ Use proper grammar and spelling in your native language
• ✅ Maintain the same tone and style as the English version
• ✅ Keep formatting codes (§ codes) in the same positions
• ✅ Preserve placeholders like %1$s, {0}, etc.
• ✅ Test your translations in-game when possible
• ✅ Keep translations concise while maintaining meaning
• ✅ Use consistent terminology throughout

DON'T:

• ❌ Use Google Translate or other automatic translation tools
• ❌ Use AI translation tools without human review
• ❌ Remove or modify formatting codes unless necessary
• ❌ Change placeholder order without adjusting the format specifiers
• ❌ Leave translations empty - mark uncertain translations with [TODO] instead
• ❌ Copy-paste English text as translation
• ❌ Use informal language unless the original does

Special Considerations:

• Item Names: Should be concise and descriptive
• Quest Text: Can be longer and more descriptive
• UI Elements: Should be short to fit interface constraints
• Technical Terms: Some mod-specific terms might be better left in English

Contributing

1. Fork the repository or get access to the translation workspace
2. Choose your language - check if it already exists
3. Use the tools provided to manage translations efficiently
4. Follow the guidelines above for quality translations
5. Test your work - verify translations work in-game
6. Submit your changes through your preferred method (PR, shared folder, etc.)

Quality Checklist:

• All translations are human-made, not machine-translated
• Formatting codes are preserved correctly
• Placeholders are maintained
• Grammar and spelling are correct
• Terminology is consistent
• Translations fit the context and tone
• No empty translation entries

Troubleshooting

Common Issues:

1. GUI won't start:

   • Make sure Python 3.7+ is installed
   • Install tkinter: pip install tk
   • Check console for error messages

2. Can't load workspace:

   • Verify the lang folder exists
   • Check that JSON files are valid
   • Ensure you have read permissions

3. Translations not saving:

   • Check write permissions in the lang folder
   • Verify JSON file structure
   • Look for error messages in the status bar

4. Formatting preview not working:

   • This is normal - the preview is simplified
   • Test formatting codes in-game for best results

Getting Help:

If you encounter issues:

1. Check the error messages in the application
2. Verify your JSON files are valid
3. Try reloading the workspace
4. Check file permissions
5. Report bugs with detailed error messages

License

This tool is provided for the Star Technology modpack translation project. Please respect the licensing of the original mod content when contributing translations.

---

Happy translating! 🌟