Locales

Add or edit translations for Chamly Drugs.

Available Languages

• 🇬🇧 English (en) - Default

• 🇵🇱 Polish (pl) - Polski

Changing Language

Edit config/main.lua:

Config.Locale = 'en'  -- Change to 'pl' for Polish

Restart resource after changing:

restart chamly_drugs

Adding New Language

Step 1: Create Locale File

Create a new file in locales/ folder:

locales/your_lang.lua

Examples:

• es.lua - Spanish

• de.lua - German

• fr.lua - French

• pt.lua - Portuguese

Step 2: Copy Template

Copy content from locales/en.lua and translate all strings:

Locale['es'] = {  -- Change 'es' to your language code
    
    -- Error messages
    ['error_no_job'] = 'No puedes hacer esto con tu trabajo actual',
    ['error_no_items'] = 'No tienes suficientes materiales',
    ['error_inventory_full'] = 'Tu inventario está lleno',
    ['error_too_far'] = 'Estás demasiado lejos',
    ['error_activity_cancelled'] = 'Actividad cancelada',
    
    -- Notifications
    ['notify_harvested'] = 'Cosechaste %s %s y recibiste %sx %s',
    ['notify_harvested_bonus'] = 'Cosechaste %s %s y recibiste %sx %s (+%s bonus)',
    ['notify_processed'] = 'Procesaste %sx %s en %sx %s',
    ['notify_not_enough_items'] = 'Necesitas %sx %s para procesar',
    
    -- Target labels
    ['target_harvest'] = 'Cosechar %s',
    ['target_process'] = 'Procesar %s',
    
    -- TextUI (Standalone mode)
    ['textui_harvest'] = 'Presiona ~INPUT_CONTEXT~ para cosechar %s',
    ['textui_process'] = 'Presiona ~INPUT_CONTEXT~ para procesar %s',
    
    -- Misc
    ['esc_to_cancel'] = 'Presiona ESC para cancelar',
    
    -- ... more translations
}

Step 3: Update Config

Edit config/main.lua:

Config.Locale = 'es'  -- Your language code

Step 4: Restart

restart chamly_drugs

Translation Keys Reference

All translatable strings are organized in categories:

Errors

['error_no_job']           -- Job restriction message
['error_no_items']         -- Not enough items
['error_inventory_full']   -- Inventory full
['error_too_far']          -- Player too far from location
['error_activity_cancelled'] -- Activity was cancelled
['error_already_harvesting'] -- Already harvesting
['error_already_processing'] -- Already processing

Notifications

['notify_harvested']       -- Successful harvest message
['notify_harvested_bonus'] -- Harvest with bonus
['notify_processed']       -- Successful processing
['notify_not_enough_items'] -- Need more materials

Target System

['target_harvest']  -- Harvest prompt (e.g., "Harvest Weed")
['target_process']  -- Process prompt (e.g., "Process Weed")

TextUI (Standalone Mode)

['textui_harvest']  -- Harvest instruction
['textui_process']  -- Process instruction

Discord Logs

['log_harvested']   -- Log message for harvesting
['log_processed']   -- Log message for processing

Placeholders

Some strings use placeholders that get replaced with actual values:

• %s - String value (drug name, item name, etc.)

• %d - Number value (amount, count, etc.)

• %sx - Amount with 'x' (e.g., "10x Weed")

Example:

-- Template
['notify_harvested'] = 'You harvested %s and received %sx %s'

-- In-game result
'You harvested Weed and received 5x Marijuana Bud'

Language Files Location

chamly_drugs/
└── locales/
    ├── en.lua  (English)
    ├── pl.lua  (Polish)
    └── your_lang.lua  (Your language)

Testing Translations

After adding translations:

1. Set Config.Locale to your language code

2. Restart resource

3. Test in-game:

   • Harvest drugs (check notifications)

   • Process drugs (check messages)

   • Trigger errors (check error messages)

   • Use target system (check prompts)

Common Translation Tips

Keep It Concise

❌ Bad: 'You have successfully harvested the marijuana plant and received items' ✅ Good: 'Harvested marijuana'

Test Lengths

Some languages are longer than English:

• German words can be very long

• Make sure UI doesn't break with long text

• Test with longest possible strings

Preserve Placeholders

Always keep %s and %d placeholders:

❌ Wrong:

['notify_harvested'] = 'Cosechaste marihuana y recibiste 5 items'

✅ Correct:

['notify_harvested'] = 'Cosechaste %s y recibiste %sx %s'

Example: Full Spanish Translation

Locale['es'] = {
    -- Errores
    ['error_no_job'] = 'Tu trabajo no te permite hacer esto',
    ['error_no_items'] = 'No tienes suficientes materiales (%sx %s)',
    ['error_inventory_full'] = 'Tu inventario está lleno',
    ['error_too_far'] = 'Te has alejado demasiado',
    ['error_activity_cancelled'] = 'Actividad cancelada',
    
    -- Notificaciones
    ['notify_harvested'] = 'Cosechaste y recibiste %sx %s',
    ['notify_processed'] = 'Procesaste %sx %s → %sx %s',
    
    -- Target
    ['target_harvest'] = 'Cosechar %s',
    ['target_process'] = 'Procesar %s',
    
    -- TextUI
    ['textui_harvest'] = 'Presiona ~INPUT_CONTEXT~ para cosechar',
    ['textui_process'] = 'Presiona ~INPUT_CONTEXT~ para procesar',
}

Need Help?

• Copy existing locale file as template

• Use Google Translate for basic translation

• Ask native speakers to review

• Test thoroughly in-game

Questions? Contact Support