Edit content group
Purpose
This screen sets up a content group in two steps: first its name, icon and description; then the group’s fields. Fields are the values every entry in this group will fill in (top speed, color, 3D model and so on). The same screen is also used to change the schema of an existing group; in that case its title is “Grubu düzenle” (Edit group).
When to use
- When setting up a new content group.
- To add a field to an existing group, change the field order or update a field’s limits.
Step by step
Set up a new group
- On the Content page press Yeni grup (New group); if you wish, choose a template.
- In step 1 / 2 write the group name. In a new group the key is suggested from the name; you can change it as you like, it does not change after saving.
- Move to the second step with Devam: alanlar (Continue: fields).
- With Alan ekle (Add field), enter a name, kind and, if needed, limits for each field. Reorder fields with the up and down arrows.
- Check how the entry form will look with the live preview on the page and say Grubu oluştur (Create group).
Change an existing group’s schema
- Press Şemayı düzenle (Edit schema) in the group’s entry list.
- The key and kind of saved fields are locked. If you need a different kind, open a new field with Yeni alan olarak ekle (Add as new field).
- Press Kaydet (Save). A schema change is also a draft, like entries; it goes to the game when you publish.
Note
If you press Vazgeç (Cancel) while there are unsaved changes, the panel asks for confirmation before leaving.
Fields and options
Group information
| Field | Required | Description |
|---|---|---|
| Group name | Yes | The name shown in the panel |
| Key | Yes | The ID the game finds the group by; fixed after saving |
| Icon | No | The icon shown on the card |
| Short description | No | At most 500 characters |
Field kinds
| Kind | What it holds | Extra settings |
|---|---|---|
| Number | Whole number | Unit, decimal places, min, max, default |
| Percent | Percentage value | Min, max, default |
| Text | Text | Max characters, multi-line |
| Yes / No | Boolean value | Default |
| Option list | Choice from a list | Options (at most 64), multiple choice possible |
| Color | #rrggbb color | None |
| 3D model | A model from the model library | None; cannot be chosen if the Scenes module is off |
| Image | An uploaded image | None |
| Another entry | A link to another entry | Target, target group |
| Table | Repeated rows, for example a level-damage table | Min rows, max rows, columns (at most 8) |
Settings common to every field
| Field | Required | Description |
|---|---|---|
| Field name | Yes | The name shown in the form |
| Key | Yes | The ID the game reads; fixed after saving |
| Kind | Yes | Does not change on a saved field |
| Visibility | Yes | Player can see, or game server only |
| Help text | No | Shown under the field in the form |
| Required | No | If left empty, the entry cannot be saved |
| Show in list | No | Also shows it in the list and summary |
A group has at most 48 fields.
Common situations
| Situation | What to do |
|---|---|
| I wrote the key wrong and saved | The key does not change. Add a new field with the right key; if the old one is no longer needed, remove it from the entries. |
| The “3D model” kind cannot be chosen | The Scenes module is off in this environment; turn the module on. |
| I cannot change a field’s kind | A saved field’s kind is fixed. Open a separate field for the new kind with Yeni alan olarak ekle. |
| Some fields have a lock icon | A plugin (for example Package & Ride) uses that field; it cannot be deleted and its kind does not change. |
| I cannot add a required text column to a saved table | Add it as optional first; a new required column is rejected because existing rows have no value. |
| “Devam: alanlar” does not move to the next step | In step 1 the name or key is missing or invalid; fix the red messages. |