Stellaron

Создайте экономическую и военную инфраструктуру. Исследуйте новейшие технологии. Создавайте альянсы и ведите переговоры с другими императорами. Постройте непобедимый флот или планетарную оборону.

Username: demo | Password: demo Войти

Stellaron Demo Version - Original Version

This README.md information in login page won't be displayed when you acquire Stellaron.

If you're still interested on acquiring Stellaron, mail us to [email protected]

A PHP browsergame based on OGame with influence of 4X games genre like Stellaris, Civilization, Endless Space, and others.

Why "Stellaron Original"

Do not misunderstand the power of this just because of a word "Original". This unique repository was created in order to keep your game identical to Stellaron, excluding external add-ons requested by other customer like you.

Understand these external add-ons as features that are not integrated on Stellaron core.

What are those "external" add-ons?

  • Dynamic Officier System (players have their own officiers and level up them)
  • Event Awaken Empire (major pvpve event where players can join one side and fight with a overpowered bot on ACS)
  • Event Universe Fortress (battle against alliances to see who conquers and owns longer the Universe Fortress megastructure)
  • Event Archaeology Exploration (random planets/bodies across the galaxy with rewards and unlockables)
  • Monthly PvP Medal Season
  • Weekly Seasonal Tasks
  • Planet celestial body modifier
  • Autofleet tools (automatic exploration, recycling and asteroid farm)
  • Archaeology System
  • OGame Class System



If you are interested in any of them, and with permission of the requester, please contact [email protected]

Getting Started

Stellaron has been tested on a Digital Ocean droplet with 2GB RAM, 2vCPUs and 50GB SSD. During gameplay, the loadpage speed was around 0.4 to 0.7ms.

This game has been tested on Vesta, CyberPanel panel and default LAMP setup. It is recommended to use CyberPanel if you are a beginner, because it auto-generates Let's Encrypt SSL for you and easy php.ini editing.

Pre-warning for versions updated before March 2020

If your server is installed with repository version below Major Update + New features + Balance + Awaken (2/03/2020), the new update will require database changes and maintenance before goes live. This update includes new features, new balance content and performance and, therefore, some database structure had to be reworked. PHP files, located at root path, used to call synchronous updates to the game (like PayPal or votesites) are now located at root/api/* folder.

Prerequisites

Required

Server requirements * VPS or Dedicated Server * 4GB RAM recommended (2GB RAM minimum) * 1GB of space minimum * Shared VPS CPU can be used * PHP = 7.3 (PHP 7.4 is UNSTABLE)

Software * SSH Access (PuTTY is recommended) * Composer

Composer required content

"require": {
    "facebook/graph-sdk": "~5.0",
    "geoip2/geoip2": "~2.0",
    "xsolla/xsolla-sdk-php": "^2.6",
    "mobiledetect/mobiledetectlib": "^2.8",
    "phpmailer/phpmailer": "^6.0",
    "paypal/rest-api-sdk-php": "*",
    "endroid/qr-code": "^3.6",
    "google/cloud-translate": "*",
    "chriskonnertz/bbcode": "*"
}

Optional

Software

  • * IPB Forum (optional, not-included, in-game interface supported)
  • * Flarum (optional, not-included, in-game interface supported)

Installation & Deployment

Download the master files zip from GitHub or import the git file on GitHub Desktop/SSH. Make sure you have permission to access the repository.

Upload to your server the file compressed and unzip through SSH/internal file manager or export the files on your computer, select all files, and drop into your server window (like FileZilla)

Composer

It is highly recommended you recompile Composer files rather than using Stellaron root/vendor/* folder. Try to follow these steps, but if you fail to compile the required assets, use Stellaron root/vendor/* instead.

On your SSH window, run this code:

php composer.phar update

Permission

When you have completed the Composer step, now open the following file:

root/includes/Stellaron.php

and change

define('IP_WHITELIST', 'string');

to your IP

define('IP_WHITELIST', 127.0.0.1); // random IP for example

In-game install

Once you have done this, access your game URL. You will be redirected to an installation setup guide.

You will be requested on step 4 to enter:
Host IP
Port
Database name
Database username
Database password

If information is entered correctly and match with server properties, you will step forward to account creation.

You will be requested on step 5 to enter:
Admin name
Admin password
Admin email

If the setup was successful, you'll be redirected to Admin Panel and when you click on "Game" button from top navigation bar and you'll get no errors.

Otherwise, if you get a error, please report to [email protected] .

Update policy and considerations

Not every update done on Stellaron are available instantly at this repository, because may need debugging with players, balance adjustments and/or achieve a stable stage.

But any bug-fix, issue reported or commits done on Steemnova (the 2Moons extension where Stellaron is based on), it gets available instantly on this repository.

Just a final note.

I understand when you open your game, you want to remove any linked text related with Stellaron, but I pledge you to keep at least any indication on login footer or login top nav bar the button that says "make your own game". You pay a great stack, true, but doesn't mean that big stack is enough to pay for extensions, server costs, test players and the hours of work invested on this unique project.

Enable Events

  1. To enable events, first it must be created an account named "System" (or any name you wish as long you edit on includes/Stellaorn.php the name that system bot account must have).
  2. If you want to enable events on multiple universes, an account named "System" must exist on the universes you want to have events. For example, you have 3 universes but you want the events to be executed in universe 2 and 3, then on those two universes you must have the account "System"
  3. It is recommended that the account "System":
    1. is banned (i.e., on uni1_users table, set bana = 1 on name = System)
    2. has administrator permissions (this prevents to appear in statistics; i.e., on uni1_users table, set authlevel = 3 on username = System)
    3. can be attacked at all costs (i.e., on uni1_users table, set authattack = -1 on username = System)
    4. the password value is empty, or same as admin or is a random generated bcrypt string (i.e., on uni1_users table, modify the password on username = System)
  4. Once a system account is set up, go to uni1_cronjob table, and on the events you want to enable on certain universe, change isActive column to 1. You may need to set time column to 0, so you can force the event to start on the exact moment you're editing the table.
    1. If the column lock looks like a random md5 hash, that means the cronjob was blocked and not executed. Check includes/error.log for more information.
    2. Certain events can have the auto-activate and auto-disable tool enabled. Please check it on includes/Stellaron.php

That's it! You have your events enabled and running on Stellaron :)

Roadmap

February - May

  • [EXCLUSIVE - NOT INCLUDED ON THIS REPOSITORY] New Interface that includes a redesigned galaxy, spacious and beautiful look and responsive to all screens - beta.stellaron.space
    • This task may be extended until June. Writing a new interface takes its time to develop and test - right now, new interface is at 70%

June

  • [EXCLUSIVE - NOT INCLUDED ON THIS REPOSITORY] Mercenaires Mod

July

  • [INCLUDED ON THIS REPOSITORY] New Installation system
  • [INCLUDED ON THIS REPOSITORY] New Multiuniverse handler
  • [INCLUDED ON THIS REPOSITORY] New Admin Panel with much more tools

Authors

  • Roberto Vilas - Initial work
  • Lu Jun - collaborator

Contacts

  • Discord - Qwatayean#8543
  • Email - [email protected]
  • Ticket support - https://stellaron.space