Skip to content

openplaceteam/openplace

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

542 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

openplace

Translations v5.3

German Flag French Flag Indonesia Flag Ukraine Flag

Openplace (styled lowercase) is a free unofficial open source backend for wplace. We aim to give the freedom and flexibility for all users to be able to make their own private wplace experience for themselves, their friends, or even their community.

[WARNING ⚠️] This is a work-in-progress. Expect unfinished features and bugs. Please help us by posting issues in #tech-support on our Discord server or by contributing pull requests. Thanks!

Getting Started

Windows

macOS

Docker

Server accessibility

You will be required to configure an SSL certificate if you plan to use this in production. However, if you are only using this with you and your friends, you can simply navigate to https://{IP}:8080 NOTE: openplace is only hosted over HTTPS. you will run into HTTP error 400 if you attempt to load the website over HTTP.

Updating your database

In the event that the database schematic changes, you simply need to run npm run db:push to update your database schema.

Adding a Translation

[WARNING ⚠️] Contributions made with AI will be rejected, and you WILL be banned from the repository. You must be proficient in the language you translate.

To contribute to this repository and translate the README.md and other installation files, please follow these steps.

Change the version number at the top of this README to indicate a new language has been added

The version number is formatted as X.XX, where the first "X" represents the number of languages officially translated so far. The second set of "X"s after the period is changed whenever any modifications are made to the English version of the README. This version number helps translators know when they need to update their existing translated content.

Create a new folder in the translations directory named after your language’s ISO code

If you’re unsure what your ISO code is, you can check it here or simply search online. You are looking for a two-letter code such as "en" for English.

Copy the English files into your new folder

Copy the English files from the translations folder and the main README.md into the folder you just created. You should now have four files: README.md and three installation markdown (.md) files.

Add the correct flag to both README

When creating a new translation, you must update two README files:

1. Original English README

Add only the flag of the country/language you are translating into at the top. This flag must link to your new translated README.

Use this template:

<a href="translations/LANGUAGE_ISO_CODE/NAME_OF_YOUR_README.md"><img src="https://flagcdn.com/256x192/LANGUAGE_ISO_CODE.png" width="48" alt="NAME_OF_COUNTRY Flag"></a>

Replace the placeholders with the ISO code and country name for your translation.

2. Your Translated README

At the top of your translated README, add only the American flag, linking back to the English README.

[WARNING ⚠️] Flags in the English README must stay in alphabetical order by ISO code.

Update links in the Getting Started section

In the Getting Started section, update the links so they point to your translated files. If you’re unsure how to do this, refer to another language folder (for example, fr).

Translate all files

Translate all the files completely and accurately. Once you’ve finished, make a pull request. A contributor or user will verify your work. Do not forget: the use of AI is strictly prohibited and will result in a permanent ban if detected.

Verify your work

Click on EVERY link and flag. Each one must work correctly and lead to the appropriate file or website. If something doesn’t work, fix it before submitting your pull request. Once everything functions as expected, you can confidently open your pull request. Remember: these guidelines will be reviewed for all translations to ensure full compliance.

License

Licensed under the Apache License, version 2.0. Refer to LICENSE.md.

Acknowledgements

Region data is from GeoNames Gazetteer, and is licensed under a Creative Commons Attribution 4.0 License. The Data is provided “as is” without warranty or any representation of accuracy, timeliness or completeness.

Releases

No releases published

Packages

No packages published

Contributors 16

Languages