OGameX

? Jika Anda menemukan proyek ini bermanfaat, silakan pertimbangkan untuk memberikannya bintang! ?

Demo Langsung • Instalasi? • berkontribusi

Open-Source Ogame Redesign Clone

Ogamex adalah klon desain ulang Open-Source Ogame. Klon ini dibangun sepenuhnya dari awal menggunakan kerangka kerja Laravel 11.x dan menggunakan praktik PHP modern. Semua fungsi utama dicakup oleh unit dan tes fitur yang secara otomatis berjalan pada setiap build.

Kami menyambut setiap dan semua kontribusi untuk proyek ini! Jika Anda ingin membantu, silakan baca bagian yang berkontribusi. Jika Anda memiliki pertanyaan, Anda dapat bergabung dengan perselisihan OGAMEX untuk menghubungi para pengelola dan kontributor lainnya.

Penafian: Proyek ini murni berbasis penggemar dan tidak mengandung fitur komersial apa pun. Semua kode backend ditulis dari awal. Hak dan konsep untuk karya seni dan frontend milik pencipta asli: Gameforge GmbH. Dukung mereka dengan memeriksa versi resmi: https://ogame.org.

Demo langsung

• Cabang Utama (Bangunan Nightly): https://main.ogamex.dev
• Rilis stabil terbaru (0.9.1) : https://release.ogamex.dev

Daftar isi

• 1. Contoh tangkapan layar
• 2. Tentang Penulis
• 3. Sasaran
• 4. Keadaan proyek saat ini
  • a) Fitur yang akan datang
• 5. berkontribusi
• 6. Penafian
• 7. Instalasi
  • A) Pengembangan: Instal Ogamex Menggunakan Docker
  • b) Produksi: Instal Ogamex Menggunakan Docker
• 8. Upgrade
• 9. Dukungan
• 10. Sponsorship
• 11. Lisensi

1. Contoh tangkapan layar

2. Tentang Penulis

Perjalanan (@lanedirt) saya ke pengembangan perangkat lunak dimulai pada 2007 pada usia 14 ketika saya menemukan kode sumber untuk Ugamela, klon PHP Open-Source awal OGAME. Saya sangat suka menjalankan server game browser saya sendiri dan mendedikasikan diri saya untuk memodifikasi versi ini dan menerjemahkannya ke Belanda, yang mengarah ke peluncuran Ogamex.nl. Server ini, aktif dari 2007 hingga 2009, memelihara komunitas kecil namun terlibat. Pengalaman ini tidak hanya memicu hasrat saya untuk pengembangan perangkat lunak tetapi juga meletakkan dasar untuk karier profesional saya. Ogame selalu memegang tempat khusus di hati saya, itulah sebabnya sekarang, 15 tahun kemudian, saya telah memutuskan untuk kembali ke sana dan membuat klon open-source ini dari bawah ke atas.

3. Sasaran

Tujuan utama dari proyek berbasis penggemar ini adalah untuk merekayasa membawakan lagu OGAME yang setia, secara khusus mencerminkan keadaan sebelum pembaruan Lifeforms yang diperkenalkan pada tahun 2020. Inisiatif ini, murni berbasis penggemar dan non-komersial, dikejar secara ketat untuk tujuan pendidikan.

4. Keadaan proyek saat ini

Ogamex sedang dalam pengembangan aktif dengan banyak fitur inti yang sudah diimplementasikan dan berfungsi:

• Planet dan manajemen sumber daya (logam, kristal, deuterium, energi)
• Sistem antrian membangun dan meneliti
• Tinjauan Galaxy
• Highscores
• Pesan
• Mesin pertempuran
• Panel Admin
• Misi pengiriman armada
  • Mengangkut
  • Penyebaran
  • Kolonisasi
  • Spionase
  • Menyerang
  • Daur ulang
• Bulan
  • Penciptaan bulan melalui ladang puing setelah pertempuran
  • Bangunan bulan

Fitur yang akan datang

Fitur besar mendatang berikutnya yang sedang dikerjakan:

• Bulan
  • Fitur Phalanx
  • Fitur Jump Gate
  • Misi Pengiriman Armada Penghancuran Bulan
• Serangan rudal
• Aliansi
• Misi pengiriman armada ACS
• Merchant & Shop (non-komersial)

5. berkontribusi

Kontribusi disambut dengan hangat, baik dalam pengembangan, pengujian, atau menyebarkan berita. Jangan ragu untuk mengirimkan permintaan tarik atau hubungi saya untuk kontribusi lainnya.

Titik awal yang baik adalah masalah yang diberi label sebagai "masalah pertama yang baik".

Baca file Contributing.md untuk informasi lebih lanjut.

? 6. Penafian

Proyek ini adalah proyek hobi non-komersial. Semua hak dan konsep yang terkait dengan OGAME dimiliki oleh Gameforge GmbH. Kami mendorong pendukung untuk mencoba OGAME resmi di https://ogame.org untuk mendukung penciptanya.

7. Instalasi

Cara yang disarankan untuk menginstal OGAMEX adalah dengan menjalankan wadah Docker yang dibundel. Ini mengurus semua ketergantungan dan merupakan cara termudah untuk memulai.

Jika Anda Insteda ingin menginstal Ogamex secara manual, lihat daftar persyaratan untuk Laravel 11.x dan cara menggunakan secara manual ke server di sini: https://laravel.com/docs/11.x/deployment.

a) Instal untuk pengembangan lokal

Untuk pengembangan lokal, gunakan file komposisi Docker default yang termasuk dalam repositori ini. Konfigurasi ini dioptimalkan untuk pengembangan dan mencakup beberapa alat yang berguna untuk debugging dan pengujian.

1. Klon Repositori.

 $ git clone https://github.com/lanedirt/OGameX.git
$ cd OGameX

2. Salin .env.example to .env .

 $ cp .env.example .env

3. Luncurkan proyek menggunakan Docker Compose:

 $ docker compose up -d

Catatan: Pengaturan default mengikat ke port 80/443. Ubah docker-compose.yml jika diperlukan. PHPMyAdmin juga disertakan untuk manajemen basis data dan terikat ke port 8080.

Setelah wadah Docker dimulai, kunjungi http: // localhost untuk mengakses Ogamex. Perhatikan bahwa mungkin perlu beberapa detik untuk memulai aplikasi. Buat akun baru dan login menggunakan akun itu. Akun pertama yang dibuat akan secara otomatis ditetapkan peran admin.

CATATAN: Jika Anda perlu menjalankan perintah manual php artisan , Anda dapat SSH ke dalam wadah ogamex-app dengan docker compose exec -it ogamex-app bash command.

b) Pasang untuk diproduksi

Untuk produksi ada file compose Docker terpisah yang disebut docker-compose.prod.yml . Konfigurasi ini berisi beberapa optimasi kinerja dan pengaturan keamanan yang tidak ada dalam konfigurasi pengembangan.

Perhatian: Konfigurasi produksi belum sepenuhnya dioptimalkan dan harus digunakan dengan hati -hati. Sebagai contoh, pengguna root database menggunakan kata sandi default yang harus diubah menjadi sesuatu yang unik. Anda harus meninjau semua pengaturan sebelum menggunakan proyek ini ke server yang dapat diakses secara publik.

Catatan: Instruksi di bawah ini untuk Linux. Ogamex juga harus bekerja di bawah Docker untuk Windows tetapi langkah -langkahnya mungkin sedikit berbeda.

1. Wadah Ogamex Docker diharapkan dijalankan di bawah pengguna (non-root) yang terpisah. Buat pengguna baru (misalnya, OGAMEX) dan tambahkan ke grup Docker:

 $ sudo useradd -m ogamex
$ sudo usermod -aG docker ogamex

2. Beralih ke pengguna baru (OGAMEX):

 $ sudo su ogamex

3. Kloning Git Repo dan jalankan perintah Docker sebagai pengguna OGAMEX untuk memastikan semua file dibuat dengan izin yang benar.

 $ git clone https://github.com/lanedirt/OGameX.git
$ cd OGameX

4. Salin .env.example-prod ke .env .

 $ cp .env.example-prod .env

5. Luncurkan proyek menggunakan Docker Compose:

 $ docker compose -f docker-compose.prod.yml up -d --build --force-recreate

Catatan: Pengaturan default mengikat ke port 80/443, untuk mengubahnya memodifikasi docker-compose.yml . PHPMyAdmin juga disertakan untuk manajemen basis data dan terikat ke port 8080, namun untuk mengaksesnya, Anda perlu secara eksplisit menentukan alamat IP Anda melalui ./docker/phpmyadmin/.htaccess untuk tujuan keselamatan.

Setelah wadah Docker dimulai, kunjungi https: // localhost untuk mengakses Ogamex. Perhatikan bahwa mungkin perlu beberapa detik untuk memulai aplikasi. Buat akun baru dan login menggunakan akun itu. Akun pertama yang dibuat akan secara otomatis ditetapkan peran admin.

Catatan: Versi produksi berjalan dalam mode paksa-https (pengalihan) secara default menggunakan sertifikat SSL yang ditandatangani sendiri. Jika Anda ingin mengakses aplikasi melalui HTTP, buka .env dan ubah APP_ENV dari production ke local .

8. Instruksi Upgrade dan Misc

Tingkatkan Ogamex ke versi baru

Jika Anda ingin meningkatkan instalasi OGAMEX yang ada ke versi baru, ikuti langkah -langkah ini:

1. Hentikan wadah yang ada:

 $ docker compose down

2. Tarik perubahan terbaru dari cabang utama atau checkout tag rilis baru:

 $ git pull origin main

-- atau --

 $ git checkout 0.9.1 # replace with the latest release tag

3. Membangun kembali dan memulai wadah:

Untuk pengembangan:

 $ docker compose up -d --build --force-recreate --remove-orphans

Untuk produksi:

 $ docker compose -f docker-compose.prod.yml up -d --build --force-recreate --remove-orphans

Ketika wadah Docker dimulai, skrip entrypoint di ./docker/entrypoint.sh akan secara otomatis menjalankan perintah instalasi Laravel yang sesuai untuk meningkatkan skema database dan menyegarkan cache. Perhatikan bahwa tergantung pada migrasi ini mungkin perlu beberapa saat. Setelah wadah dimulai, Anda dapat mengunjungi aplikasi di https://localhost (atau http: // localhost) untuk memeriksa apakah peningkatan berhasil. Jika Anda mengalami masalah apa pun, silakan periksa log untuk informasi lebih lanjut atau buka masalah di GitHub.

Menetapkan peran admin

Secara default, pengguna terdaftar pertama ditugaskan peran admin yang dapat melihat bilah admin dan dapat mengubah pengaturan server. Anda juga dapat menetapkan peran admin secara manual melalui baris perintah:

 $ php artisan ogamex:assign-admin-role {username}

Untuk menghapus peran admin dari pengguna, gunakan perintah berikut:

 $ php artisan ogamex:remove-admin-role {username}

? 9. Dukungan

Apakah Anda menghadapi masalah dalam proyek ini? Harap buka tiket di GitHub dan kami akan mencoba membantu Anda sesegera mungkin.

? 10. Sponsorship

Kami berterima kasih kepada pihak -pihak berikut karena mensponsori proyek ini:

JetBrains Memberikan lisensi sumber terbuka gratis untuk phpstorm, badai web, dan datagrip.

Tertarik mendukung Ogamex? Kami menyambut sponsor semua ukuran! Dukungan Anda membantu kami mempertahankan dan meningkatkan proyek open-source ini. Harap hubungi kami melalui GitHub atau perselisihan untuk membahas peluang sponsor.

? 11. Lisensi

Kode Sumber Ogamex Laravel adalah perangkat lunak open-source yang dilisensikan di bawah lisensi MIT. Lihat file lisensi untuk lebih jelasnya. Semua hak dan konsep yang terkait dengan OGAME dimiliki oleh Gameforge GmbH.