Fabiann227/AdvancedRP-SAMP

🎮 Advanced Roleplay - SA-MP Server

Advanced Roleplay adalah server roleplay San Andreas Multiplayer (SA-MP) yang dikembangkan dengan bahasa Pawn.

---

📋 Daftar Isi

• Tentang Project
• Fitur Utama
• Struktur Project
• Requirements
• Instalasi
• Konfigurasi Database
• Kompilasi/Build
• Menjalankan Server
• Plugins
• Modul System
• Credits
• Lisensi

---

📖 Tentang Project

Advanced Roleplay adalah gamemode roleplay berbasis script South Central Roleplay yang telah dimodifikasi dan dikembangkan lebih lanjut. Server ini menyediakan pengalaman roleplay yang realistis dengan berbagai sistem dan fitur yang lengkap.

Informasi Script

• Versi: V2.0+
• Base Script: South Central Roleplay
• Developer: Leynardo Yosef (Revelt) & Rachmad Setiawan (sheenidgs)

---

✨ Fitur Utama

🏢 Sistem Dinamis

• Actor System - NPC interaktif untuk robbery dan lainnya
• Apartment System - Sistem apartemen
• ATM System - Mesin ATM tersebar di map
• Business System - Sistem bisnis dengan employee management
• Gate System - Gerbang dinamis
• Vehicle System - Sistem kendaraan lengkap dengan gunrack, vkeys, speedradar
• Market System - Sistem pasar/toko
• Gas Pump System - SPBU
• Cargo System - Sistem kargo
• Dealer System - Sistem dealer kendaraan
• Plant System - Sistem pertanian/tanaman
• Tutorial System - Tutorial untuk pemain baru

👤 Sistem Player

• Faction System - Sistem fraksi (LSPD, Gang, dll)
• Weapon System - Sistem senjata lengkap
• VIP System - Sistem VIP dengan berbagai benefit
• Coins System - Mata uang virtual
• Report System - Sistem laporan player
• Wardrobe System - Sistem pakaian
• Animation System - Ratusan animasi
• Gambling System - Blackjack dan game lainnya
• Items/Inventory - Sistem item (Boombox, dll)
• Blacklist System - Sistem blacklist

💼 Sistem Pekerjaan

• Farmer - Pekerjaan petani
• Mechanic - Pekerjaan mekanik
• Job Skills - Sistem skill untuk setiap pekerjaan
• Lumber - Pekerjaan penebang kayu

🛡️ Sistem Admin

• Admin Activities - Log aktivitas admin
• Admin Duty Times - Pelacakan waktu duty admin
• Admin Event - Sistem event admin
• Admin Commands - Command admin lengkap

🔒 Sistem Keamanan

• Anti-Cheat (NEX-AC) - Sistem anti-cheat terintegrasi
• Aimbot Detection - Deteksi aimbot
• Anti-Spam - Proteksi spam
• Crash Detection - Deteksi dan logging crash

🌍 Mapping

• Custom Interiors & Exteriors
• Bank, LSPD, Jail, Mechanic Shop
• Newbie School, DMV
• Dan banyak lagi...

🔧 Fitur Lainnya

• Real-time Clock - Jam real-time
• Weather System - Sistem cuaca dinamis
• Economy System - Sistem ekonomi server
• Discord Integration - Logging ke Discord
• Email Verification - Verifikasi email saat registrasi

---

📁 Struktur Project

Advanced Roleplay/
├── 📂 db/                      # Database SQL files
│   └── advanced.sql            # Main database schema
├── 📂 filterscripts/           # Filterscripts
│   ├── CustomExteriors.pwn     # Custom exterior objects
│   ├── CustomInteriors.pwn     # Custom interior objects
│   ├── StaticLocations.amx     # Static map locations
│   └── FastDL.amx              # Fast download system
├── 📂 gamemodes/               # Main gamemode
│   ├── main.pwn                # Entry point script
│   └── 📂 modules/             # Modular scripts
│       ├── 📂 admin/           # Admin systems
│       ├── 📂 api/             # API integrations
│       ├── 📂 core/            # Core functions & defines
│       ├── 📂 demo/            # Login/Register system
│       ├── 📂 dynamic/         # Dynamic entities
│       ├── 📂 jobs/            # Job systems
│       ├── 📂 mapping/         # Custom maps
│       ├── 📂 misc/            # Miscellaneous features
│       ├── 📂 player/          # Player systems
│       ├── 📂 server/          # Server-wide systems
│       └── 📂 vehicle/         # Vehicle systems
├── 📂 models/                  # Custom .dff dan .txd files
├── 📂 pawno/                   # Pawn compiler & includes
│   └── 📂 include/             # Library includes
├── 📂 plugins/                 # Server plugins (.dll/.so)
├── 📂 scriptfiles/             # Data files
├── 📂 logs/                    # Log files
├── server.cfg                  # Server configuration
├── mysql.ini                   # MySQL configuration
├── example.mysql.ini           # Example MySQL config
└── compile.sh                  # Build script (Docker)

---

💻 Requirements

Software

• SA-MP Server 0.3.DL-R1
• MySQL/MariaDB 10.4+ atau MySQL 5.7+
• Pawn Compiler (tersedia di folder pawno/)

Plugins (Sudah Include)

Semua plugin yang diperlukan sudah tersedia di folder plugins/:

---

🔧 Instalasi

1. Clone Repository

git clone https://github.com/username/advanced-roleplay.git
cd advanced-roleplay

2. Install SA-MP Server

Download SA-MP Server 0.3.DL-R1 dari sa-mp.com atau sumber terpercaya lainnya.

3. Setup Database

Lihat bagian Konfigurasi Database.

4. Kompilasi Gamemode

Lihat bagian Kompilasi/Build.

5. Jalankan Server

Lihat bagian Menjalankan Server.

---

🗄️ Konfigurasi Database

1. Buat Database

CREATE DATABASE adv CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

2. Import Schema

mysql -u root -p adv < db/advanced.sql

Atau melalui phpMyAdmin:

1. Buka phpMyAdmin
2. Pilih database adv
3. Klik tab "Import"
4. Pilih file db/advanced.sql
5. Klik "Go"

3. Konfigurasi Koneksi

Edit file mysql.ini:

hostname = 127.0.0.1
username = root
password = your_password
database = adv
auto_reconnect = true
pool_size = 10
server_port = 3306

Note: Jangan lupa ganti your_password dengan password MySQL Anda.

---

🔨 Kompilasi/Build

Metode 1: Menggunakan Pawno (Windows)

1. Buka folder pawno/
2. Jalankan pawno.exe
3. Buka file gamemodes/main.pwn
4. Tekan F5 atau klik Build > Compile
5. File main.amx akan terbuat di folder gamemodes/

Metode 2: Command Line (Windows)

cd pawno
pawncc.exe ../gamemodes/main.pwn -o../gamemodes/main.amx -d3 -;+ -(+

Metode 3: Docker (Linux/macOS)

chmod +x compile.sh
./compile.sh

Script ini menggunakan Docker image sheenidgs/samp_pawncc_win32:0.3.DL-R1.

Metode 4: Menggunakan sampctl

Jika Anda menggunakan sampctl:

sampctl package build

Compiler Flags

---

🚀 Menjalankan Server

Windows

1. Double-click samp-server.exe

Atau melalui Command Prompt:

samp-server.exe

Linux

./samp03svr

Note: Pastikan file memiliki permission executable:

chmod +x samp03svr

Konfigurasi Server

Edit server.cfg untuk mengkustomisasi server:

gamemode0 main
filterscripts CustomExteriors StaticLocations
plugins crashdetect streamer mysql sscanf gvar chrono pawnraknet mapandreas samp-compat
rcon_password your_secure_password
port 7777
hostname Advanced Roleplay | Your Server Name
maxplayers 100
language English
useartwork 1

Port yang Digunakan

---

📦 Plugins

Plugin Files

Windows (.dll)

plugins/
├── chrono.dll
├── crashdetect.dll
├── gvar.dll
├── mapandreas.dll
├── mysql.dll
├── pawnraknet.dll
├── samp-compat.dll
├── sscanf.dll
└── streamer.dll

Linux (.so)

plugins/
├── chrono.so
├── crashdetect.so
├── gvar.so
├── mapandreas.so
├── mysql.so
├── pawnraknet.so
├── samp-compat.so
├── sscanf.so
└── streamer.so

Dokumentasi Plugin

---

📚 Modul System

Core Modules (modules/core/)

Player Modules (modules/player/)

Dynamic Modules (modules/dynamic/)

Server Modules (modules/server/)

---

🛠️ Development

Mengaktifkan Debug Mode

Uncomment baris berikut di main.pwn:

#define DEBUG_MODE

Logging

Server log tersimpan di:

• server_log.txt - Main server log
• logs/plugins/ - Plugin-specific logs
• crashinfo.txt - Crash information

Coding Standards

• Gunakan camelCase untuk nama fungsi
• Gunakan UPPER_CASE untuk konstanta
• Gunakan PascalCase untuk enum
• Comment kode dalam Bahasa Indonesia/Inggris

---

🤝 Contributing

1. Fork repository ini
2. Buat branch fitur (git checkout -b feature/AmazingFeature)
3. Commit perubahan (git commit -m 'Add some AmazingFeature')
4. Push ke branch (git push origin feature/AmazingFeature)
5. Buat Pull Request

---

👏 Credits

Developers

• Leynardo Yosef (Revelt) - Lead Developer
• Rachmad Setiawan (sheenidgs) - Lead Developer

Special Thanks

• Kalcor (Kye) - SA-MP Developer
• Y_Less - sscanf, YSI Library
• BlueG & maddinat0r - MySQL Plugin
• Southclaw - Progressbar2, chrono
• Emmet_ - Original Base Script, easyDialog, etc.
• JustMichael - Performance Improvements
• Incognito - Streamer Plugin
• Zeex - crashdetect, ZCMD

---

⚠️ Disclaimer

• Script ini untuk keperluan educational dan development.
• Pastikan untuk mengubah semua password default sebelum deployment.
• Backup database secara berkala.
• Server ini membutuhkan SA-MP 0.3.DL-R1 untuk custom models.

---

📄 Lisensi

Copyright (c) 2020 Leynardo Yosef (Revelt) & Rachmad Setiawan (sheenidgs)
All rights reserved.

---

Made with ❤️ for SA-MP Community

⬆ Kembali ke atas