Gunmarks

How it works

Translating the Gunmarks mods: from a suggestion to the players’ games, and what to keep in mind on the way.

How it works

I write the mods in English. Every text they show is listed here, with what it means, where the game shows it and how much room it has. A text nobody has translated yet shows in English.

  1. You suggest. Signed in with Discord, you pick your language and write a translation of a text. The page checks it as you type. Others can vote for a suggestion they like.

  2. A reviewer decides. A reviewer of the language approves it, asks you for a change, or rejects it. A reviewer who would write it otherwise sends their own version, and another reviewer decides on that. You are told, with their words, in the bell and on My translations.

  3. Players get it. An approved translation goes into the next release of the mod it belongs to: every release I build takes all the translations approved by then. Players see it once they install that release.

When I change an English text, its translation is not thrown away: it comes back as a suggestion, with the change shown word by word, for a reviewer to confirm or fix.

Keys in the editor: Alt+Down and Alt+Up open the next and the previous text, Ctrl+Enter sends.

A text in your language is in one of these states:

Approved
Approved for the English as it is now.
Waiting for review
No approved translation yet, and a suggestion waits for review.
Outdated
Approved for an English that changed since.
Not translated
No translation and no suggestion yet.

And a suggestion is:

Waiting for review
Sent, and waiting for a reviewer of its language.
Changes requested
A reviewer asked for a change: their words say what. Change it, and it waits for review again.
Approved
It goes into the next release of the mod.
Outdated
Approved for an English that changed since: the new English needs a new look.
Rejected
A reviewer said no, with a reason. Write a new one if you like.
Withdrawn
Taken back by its author, or replaced by their newer suggestion.
Replaced
Was approved, until a newer translation of the same text was approved.
Not chosen
A reviewer approved their own changed version of it instead.
Unpublished
Taken out of the next release by a manager, with a reason.

A word in braces, like {count} or {name}, stands for a value the game puts in: a number, a tank’s name. Keep every one, spelled as in the English. Move it to where your language needs it.

Some are filled in by the page itself (the text says so): keep those exactly once. Braces belong to placeholders: a { or } of your own, alone or doubled, can’t be used. Markup in capitals, like {HEADER}, stays as it is, and so do tags and web addresses: the checks refuse what the English does not have.

A text with a number has one form for each plural form of your language, each with the numbers it is used for. English has two (1 tank, 2 tanks); Polish has three (1 czołg, 2 czołgi, 5 czołgów); Japanese has one. Write every form.

Put {count} in each form used for more than one number, so the player sees which. In a form used only for 1, you may write the word for one instead.

Some words come back in many texts. The glossary keeps one translation of each, the game’s own word where the game has one: a term is marked in the English, and its word is a chip under the field. Use it, so a thing has one name everywhere.

A few are never translated, and the checks keep them: gunmarks.app, Gunmarks, XVM, openwg_gameface, Alt, F9, F10, F11, WN8, WTR. Translation memory shows how alike English was translated elsewhere in the mods.

Room is short on buttons, tabs and columns. Where a text has a limit the game holds it to, the page counts the characters and refuses more; elsewhere the room is a hint. A shorter word fits better than a cut one.

Write in normal case: where the game shows a text in capitals, the mod capitalizes it. Some characters cannot be drawn by the game’s fonts for your language: the checks name them, so you can pick another.

Write it as a player says it in your language, not word for word. Use the game’s own names for its things: the words the game uses in your language. Be short.

Each language has a style note, written by its reviewers, on its page. Read it before you start.

Becoming a reviewer

Top: the parts of the guide

Reviewers are players who know their language well, and have translated here. They decide on its suggestions and keep its style note. A reviewer’s own translation, or their change to somebody’s, is approved by another reviewer. Where a language has only one reviewer, I can let them approve their own.

Want to review? Tell me on Discord: your language, and your name here. I give the right to review one language at a time.

Your name is shown with your translations only if you choose so, on My translations. Otherwise you are “a contributor” to everyone but the reviewers of your languages, who see who sent what.

By suggesting a translation, you agree that I may use it in the Gunmarks mods and on gunmarks.app, change it, and give it to every player, for free, for as long as the mods exist. You keep the credit you chose. Ask me on Discord and I take your name off your translations.

Send only what you wrote yourself, or what you may share: never text copied from another game or mod.