Ви не можете вибрати більше 25 тем Теми мають розпочинатися з літери або цифри, можуть містити дефіси (-) і не повинні перевищувати 35 символів.
Linus Vanas acdb641e3b Päivitä LueMinut. 1 тиждень тому
src Korjaa po2json.sh. 1 тиждень тому
.gitignore Uudelleenjärjestele projekti. 1 тиждень тому
GPL-LICENSE.txt Uudelleenjärjestele projekti. 1 тиждень тому
LGPL-LICENSE.txt Uudelleenjärjestele projekti. 1 тиждень тому
LueMinut.txt Päivitä LueMinut. 1 тиждень тому
Makefile Uudelleenjärjestele projekti. 1 тиждень тому
ReadMe.txt Päivitä LueMinut. 1 тиждень тому
copyright.txt Ota asiakasohjelmassa käyttöön (eräs) gettext.js-kirjasto. 3 місяці тому
gpl-3.0.txt Uudelleenjärjestele projekti. 1 тиждень тому

ReadMe.txt

Veturi 0.9 ReadMe

1. Description

Veturi <https://huitsi.net/games/veturi/> is a simultaneous turn-based strategy game
developed for the wars of the Finnish nation-RPG Valtioroolipeli <https://valtioroolipeli.boards.net/>.
It's designed to run on most web hosting setups, essentially only requiring PHP (7.3) and an MySQL- (or MariaDB-) database.
Veturi is meant to be used alongside an existing community and doesn't include any in-game communication.
Also, the admin is expected to create all the accounts and deliver the credentials to the users.

Veturi can be seen as made up of four parts:
1. The client is web application (JS, HTML, CSS) that the players can use
to plan and send their orders.
2. The client/server-interface (PHP) logins and receiving orders
from the client and saving them to the database.
4. The admin-interface (PHP, HTML), used for example to create accounts and edit configurations.
3. The turn simulator (PHP) loads the orders from the database and changes to world according to them.

2. Changelog

0.9:
* Continue refactoring.
* Add an order to build a unit.
* Implement quick tools to create provinces, connections and units.

0.8:
Client
* Refactor the client.
* Add a drop-down menu to orders for selecting game objects.
* Reload previously saved orders upon login.
* Use Gettext to translate the client.
* Draw connections over the edge of the map when it's the shortest route.

Admin interface:
* Make database-settings MySQL-specific.
* Fix database initialization using old configuration.
* Prevent the client from using outdated cache.
* Use the same login for all admin functions.
* Add admin privilege levels.
* Hash the configuration password.

0.7:
* Create a new admin UI.
* Add an order to create a country.

0.6:
* Concatenate the JS-source code into a single file for use.
* Add an order to create a connection between two provinces.
* Show information about the game object that was clicked on the map.
* Present orders more compactly.
0.5:
Veturi 0.5 is the first version to have all the parts implemented and working to atleast some degree.
Otherwise however, it is extremely unfinished and the only implemented order is adding provinces.

3. Installation and setup

The instructions are pretty general and assume you know how to use your web hosting setup.

Veturi is built with GNU tools, notably make and gettext (msgfmt, msgmerge, xgettext). Running make will produce the ready-to-deploy veturi-directory.
The instruction below are for this directory and its contents.

Veturi should be installed so that the www-directory is accessible from the web while
keeping the whole directory structure intact. If necessary you can make the Veturi root
directory accessible too, so that the address for the client becomes for example
https://veturi.exmaple.org/www/. In that case, make sure that other files
in the root directory are NOT accessible from the web. For example,
https://veturi.exmaple.org/ReadMe.txt should give a 403-error.

After installation, the Veturi client should be found under the Veturi web root (for example https://veturi.exmaple.org/ or https://veturi.exmaple.org/www/).
The admin user interface is found under it in the admin-directory (for example https://veturi.exmaple.org/admin/ or https://veturi.exmaple.org/www/admin/).

Start with the preconfig in the sub-path admin/config/preconfig/ (for example https://veturi.exmaple.org/admin/config/preconfig/).
Choose the language you wish the Veturi admin interface to use and click the submit button.
If everything went right the page should now tell you the password you need to make the other settings. Make sure to copy it somewhere.

Next, make the database settings in the sub-path admin/config/database/ (for example https://veturi.exmaple.org/admin/config/database/).
To understand the Database settings, please see <https://www.php.net/manual/en/pdo.construct.php>.

Continue with the client settings in the sub-path admin/config/client/ (for example https://veturi.exmaple.org/admin/config/client/).
Select the client language (which can be different from the language of the admin interface) and upload a background image for the game map.
The width and height should be the same, or at least have the same aspect ratio, as your background image, as it is stretched to match.

Finally, create a game-admin account in the subpath admin/config/postconfig/ (for example https://veturi.exmaple.org/admin/config/postconfig/).
You only need to give the account a name as the page will give you the account's generated password after a successful creation.

4. Usage

Veturi is used with a browser.
After installation, the Veturi client should be found under the Veturi web root (for example https://veturi.exmaple.org/ or https://veturi.exmaple.org/www/).
The admin user interface is found under it in the admin-directory (for example https://veturi.exmaple.org/admin/ or https://veturi.exmaple.org/www/admin/).

To change turn and simulate its events, run turnsim/RUN_TURNSIM.php with PHP. You can set this up to be ran periodically.

5. Copyright

Please see copyright.txt