Skip to content

Latest commit

 

History

History
154 lines (107 loc) · 7.71 KB

README.md

File metadata and controls

154 lines (107 loc) · 7.71 KB
Raw

DnD5e German Translation (Deutsch) for FoundryVTT (FoundryVTT-dnd5e-DE)

GitHub release (latest SemVer) GitHub Downloads All Releases GitHub Downloads Release GitHub Release Date

German translation module for the Dungeons & Dragons 5th Edition (dnd5e) system for Foundry Virtual Tabletop.

Aims to provide consistent and usable translations in german for all 5E system content, including compendia via Babele.

IF YOU WANT TO HELP OUT WITH COMPENDIUM TRANSLATIONS, USE THIS SITE AND GET IN TOUCH WITH crash#7509 ON DISCORD.

The compendium content is currently in the process of being translated. This is still ongoing. Some or even most compendium content still remaining in english isn't an error on your side. We're working on it! More news soon. Compendium translations files are currently included as a submodule from here.

How to use

Install via Foundry or by pasting the URL below into Foundry's module manager:

https://github.com/mhilbrunner/foundryvtt-dnd5e-lang-de/releases/latest/download/module.json

If you want to install a specific release, have a look at the releases page:

https://github.com/mhilbrunner/foundryvtt-dnd5e-lang-de/releases

There you can find the link to the manifest of a specific release version to use instead.

Installing and using the german translation

  1. Install the module via the Foundry module manager as described above
  2. Install the dependencies: the german core translation and Babele
  3. Make sure to enable all these installed modules
  4. Make sure to set the client language to german in the settings

Requirements & dependencies

You can see all past releases and compatible versions on the official package listing here. Old versions may still be available on the old League repository.

Release 1.6.0 is compatible with Foundry versions 0.7.5 to 9. Releases after that are only compatible with Foundry 10+.

The module depends on the german core translation for ease of use.
The module also depends on Babele for compendium translations.

Changelog

See CHANGELOG.md. Also see the releases page.

Old versions may still be available on the old League repository.

Contributing & adding translations

Contributions are always welcome! Feel free to open Pull Requests or talk to us first by opening a issue or see Contact below.

Below are some ways to contribute, and how to get started.

Adding new translation strings

To add new translations:

  1. Fork this repo and check it out locally
  2. Copy the up to date english language file into languages/en.json (from here)
  3. Run compare.py
  4. languages/diff.txt should now contain keys which need to be translated
  5. After translating, run merge.py
  6. de.json should now contain updated translations
  7. Commit, push and submit a Pull Request!

Adding new compendium translations

This is a bit more involved, as compendia are currently translated using the awesome Babele module. The Babele repository has a brief tutorial.

In short, compendium translations are included as a submodule in compendium/from here.

In cases where there is only a small set of values for a field (like Alignments), those are translated using Babele converter functions in src/: https://github.com/mhilbrunner/foundryvtt-dnd5e-lang-de/blob/compendia/src/converters.js

Those are also useful for translation values that are used in multiple places, like Item Rarities.

Thanks and credits

Thanks to all current, past and future contributors, including:
Hydroxi, Smicman, ThoGri, Morvar, Fallayn, crash, elbracht, stillday, CarnVanBeck, mhilbrunner

Much love to Foundry, Atropos & team and the awesome Foundry community, especially the League, the official Discord and Reddit and the Wiki and Hub.

Thanks to all the module authors and contributors who work tirelessly and largely for free to make using Foundry such an amazing and fun experience.

Thanks to the other Foundry translations, especially the italian, polish, japanese and brazilian portoguese ones for paving the way - we learned a lot from them. :)

Thanks to Simone Ricciardi (riccisi) for Babele, without which translating compendium contents would be hard to impossible. Thanks!

And thanks to henry4k who provides the german core translation, letting us focus on the 5E system translations.

Finally, thanks to WotC for the support and all the wonderful authors - for everything.

Based on work by Hydroxi at https://gitlab.com/Hydroxi/foundryvtt-dnd5e-lang-de and by Fallayn at https://github.com/League-of-Foundry-Developers/foundryvtt-dnd5e-lang-de/.

Legal & license

This repository aims to only provide translations and no original content, and is provided as-is, for free, at no charge, with no guarantees or warranties, implied or otherwise.

As such, it is not an original work and doesn't hold any creativity and thus shouldn't meet the bars and requirements for copyright in most countries and jurisdictions. We as authors intend for it to enrich the community and be part of the public domain.

If that is not enough for you however, you may alternatively use all contents and source code that aren't owned by anyone else (e.g. Foundry, or other module authors, or WotC) under the terms of either the MIT or the Creative Commons Attribution 4.0 International (CC BY 4.0) licenses, whichever you prefer.

Regarding Foundry, this is a work under the Limited License Agreement for module development, as outlined here.

SRD content is licensed from Wizards of the Coast under the terms of the Open Gaming License (OGL), as outlined here.

Copyrighted content is licensed or used with permission. If you believe there to be an error, please feel free to contact us on Discord or by creating an Issue here.