simcity-panel - GitLite

KO | EN

gitlite — search

#tailwindcss #generative-ai #linux #claude-code #computer-vision #large-language-models #self-hosted #golang #nlp #database

simcity-panel

(★ 9)

Bảng điều khiển bot SimCity + máy chủ VLTK/JX1 — chỉnh thông số game qua giao diện web tiếng Việt, không cần biết code

파일 탐색기

ZIP 다운로드

- - manifest.json
  - simcity-config.lua
  - simcity-group_fighter.class.lua
  - simcity-pnpcinfo.lua
  - simcity-pthanhthi.lua
  - simcity-ptieuthiep.lua
  - simcity-sim.core.lua
  - simcity-sim.fun.lua
  - simcity-sim.movement.lua
- __init__.py
- backup_service.py
- config_store.py
- detect_service.py
- droprate_detail_service.py
- droprate_service.py
- event_patch_service.py
- gm_catalog.py
- gm_service.py
- ini_config_parser.py
- list_service.py
- lua_config_parser.py
- power_service.py
- price_service.py
- scan_service.py
- seasonal_event_service.py
- server_config_catalog.py
- simcity_catalog.py
- ssh_service.py
- tcvn3_codec.py
- tsv_service.py
- update_service.py
- huong-dan-sua-hanh-vi-bot.md
- - phase-00-nen-tang-xac-minh-api.md
  - phase-01-teleport-nhanh.md
  - phase-02-pk-thanh-thi-solo-bot.md
  - phase-03-lien-dau-voi-bot.md
  - phase-04-giao-dich-that-voi-bot.md
  - phase-05-ngu-canh-doi-thoai.md
  - phase-06-van-tieu-cuop-tieu.md
  - phase-07-gia-lap-nguoi-choi-that.md
  - phase-08-map-an-map-hoat-dong.md
  - plan.md
  - research-findings.md
- - brainstorm-260717-preset-easymode-exp-drop.md
- app.js
- favicon.ico
- style.css
- index.html
.gitattributes
.gitignore
app.py
install.ps1
launcher.pyw
preview.html
README.md
requirements.txt
start.bat
version.txt

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Phần mềm chạy trên máy tính của bạn, giúp **chỉnh thông số bot SimCity và máy chủ game**
(VLTK/JX1 private server) bằng giao diện web tiếng Việt — **không cần biết code**.

Mọi thông số đều có nhãn tiếng Việt + giải thích. Sửa xong bấm Lưu là ghi thẳng vào máy chủ,
tự sao lưu bản cũ, khôi phục được bất cứ lúc nào.

---

## Cài đặt — chỉ 1 dòng lệnh

1. Bấm nút **Start** của Windows, gõ `powershell`, mở **Windows PowerShell**.
2. Dán dòng dưới đây vào rồi nhấn Enter:

```powershell
irm https://raw.githubusercontent.com/TUAN130294/simcity-panel/main/install.ps1 | iex
```

Vậy là xong. Máy sẽ tự:
- Cài Python nếu chưa có
- Tải panel về
- **Tạo shortcut "SimCity Panel" ngoài màn hình**
- Mở luôn trang điều khiển

Lần sau chỉ cần **bấm đúp shortcut ngoài Desktop**.

> **Cập nhật bản mới:** chạy lại đúng dòng lệnh trên. Cài đặt kết nối của bạn được giữ nguyên.

---

## Lần chạy đầu — kết nối tới máy chủ

App tự mở cửa sổ Cài đặt và **tự dò máy chủ game** giúp bạn:
- Tìm file `config.ini` của client VLTK (trong đó có sẵn IP + mật khẩu máy chủ), hoặc
- Quét mạng nội bộ tìm máy có thư mục game `/home/jxser`

Nếu dò không ra: nhập tay **VM Host** (IP máy ảo), **User** (`root`), **Password** rồi bấm
**Test** để kiểm tra, xong bấm **Lưu**.

---

## Tính năng nổi bật

- **Cài 1 lệnh, cập nhật 1 lệnh** — tự cài Python, tự tạo shortcut, giữ nguyên cài đặt cũ.
- **Tự dò máy chủ game** — đọc `config.ini` của client hoặc quét mạng LAN, không cần biết IP/SSH.
- **Hơn 200 thông số nhãn tiếng Việt có giải thích** — bot SimCity, exp/drop, Tống Kim, Phong Hỏa
  Liên Thành, shop, đấu giá, truy nã, chống nghiện... mọi nhãn đều đã đối chiếu với code thật.
- **Một nút "Kích hoạt chỉnh event"** — server còn nguyên bản gốc? Panel tự nhận diện và tự vá
  21 file script (đối chiếu từng byte, file lạ tự bỏ qua, tất cả đều có backup) để mọi ô đều có tác dụng.
- **Mở event 2 hệ:** 40+ sự kiện cổ 2005–2010 (đồ rơi qua Túi nguyên liệu — chỉnh được tỉ lệ rơi,
  cấp quái) và 8 **Event theo mùa 2010–2012 trọn gói** (Giáng Sinh 2011 có Ông già Noel, tuần lộc,
  hộp quà giờ vàng; Trung Thu 2010; Tình nhân 2012...) — bật/tắt 1 nút, tự vá hạn dùng vật phẩm cũ.
- **Chỉnh tỉ lệ rơi đồ toàn server theo nhóm** (x0.5 → x50, trả về gốc bất cứ lúc nào).
- **An toàn là mặc định** — mọi lần ghi đè đều chụp bản cũ vào tab Backup (khôi phục 1 nút),
  sửa đúng dòng giữ nguyên từng byte TCVN3/GBK, panel chỉ chạy trên máy bạn (`127.0.0.1`).

## Các tab

| Tab | Dùng để làm gì |
|---|---|
| 🎛️ **Bot SimCity** | Số lượng bot, tốc độ chạy/đánh, máu, độ hung hăng, chat, tiền rơi... |
| ⚙️ **Máy Chủ** | Tỉ lệ Exp/tiền, tỉ lệ rơi đồ toàn server, Tống Kim, Phong Hỏa Liên Thành, bật/tắt tính năng |
| 🧩 **Nâng cao** | Thông số nằm ở các file khác |
| 📜 **Danh sách dữ liệu** | Câu chat của bot, tên bang hội, chức vụ — gõ tiếng Việt bình thường |
| 📝 **Sửa file thô** | Mở thẳng file `.lua` để sửa tay (có nút hiện tiếng Việt) |
| 🕐 **Backup** | Lịch sử sao lưu: sửa gì, lúc nào — bấm để khôi phục |
| ❓ **Hướng dẫn** | Cách sửa hành vi bot |

**Lưu ý quan trọng:** chỉnh xong phải bấm **Restart server** thì máy chủ mới áp dụng (mất 1–3 phút).

---

## Câu hỏi thường gặp

**Có an toàn không?** Panel chỉ chạy trên máy bạn (`127.0.0.1`), người ngoài không truy cập được.
Mỗi lần ghi đè file game đều tự chụp lại bản cũ — vào tab **Backup** khôi phục được.

**Chữ tiếng Việt trong game bị vỡ?** File game dùng bảng mã cũ TCVN3. Panel **tự chuyển đổi** —
bạn cứ gõ tiếng Việt Unicode bình thường (Unikey như thường ngày).

**Lỡ chỉnh hỏng game?** Vào tab **Backup**, tìm bản trước lúc chỉnh sai, bấm **Khôi phục**,
rồi **Restart server**.

**Bấm shortcut không lên gì?** Mở thư mục `%LOCALAPPDATA%\SimCityPanel`, xem file
`loi-khoi-dong.txt`. Hoặc chạy `start.bat` trong thư mục đó để thấy thông báo lỗi chi tiết.

---

## Dành cho người rành kỹ thuật

Chạy từ mã nguồn:

```bash
pip install -r requirements.txt
python app.py     # http://127.0.0.1:5666
```

- **Kết nối:** SSH/SFTP qua `paramiko`. Thông tin lưu ở `settings.json` (đã `.gitignore` —
  **không bao giờ** commit file này, nó chứa mật khẩu VM).
- **Sửa file:** đọc/ghi bằng `latin-1` (byte-faithful) để không vỡ chữ TCVN3/GBK. Chỉ ghi lại
  đúng dòng thay đổi, giữ nguyên comment và mọi byte khác.
- **Nhãn thông số:** `backend/simcity_catalog.py` (bot), `backend/server_config_catalog.py` (máy chủ).
- **Backup:** `backend/backup_service.py` — snapshot + manifest trên VM tại
  `/home/jxser/simcity-panel-backups/`.
- **Restart game:** `jx.sh reload` chạy nền (script này **không có** lệnh `restart`), panel poll
  `pgrep -x jx_linux_y` để biết khi nào game lên lại.

### Cấu trúc

```
simcity-panel/
  app.py                        # Flask + REST API
  launcher.pyw                  # bộ khởi động cho shortcut (chạy ẩn)
  install.ps1                   # bộ cài 1 lệnh
  backend/
    config_store.py             # settings.json + nhập từ client config.ini
    detect_service.py           # tự dò máy chủ (config.ini / quét LAN)
    ssh_service.py              # paramiko SSH/SFTP
    lua_config_parser.py        # parse & patch hằng số Lua theo dòng
    ini_config_parser.py        # parse & patch file .ini theo dòng
    simcity_catalog.py          # nhãn tiếng Việt cho thông số bot
    server_config_catalog.py    # nhãn tiếng Việt cho thông số máy chủ
    scan_service.py             # quét hằng global ở file khác
    list_service.py             # danh sách chuỗi (chat, tên bang)
    tcvn3_codec.py              # chuyển mã TCVN3 <-> Unicode
    droprate_service.py         # hệ số rơi đồ toàn server
    backup_service.py           # lịch sử backup + khôi phục
  templates/index.html
  static/app.js, style.css, favicon.ico
  settings.json                 # tự tạo, chứa mật khẩu VM — KHÔNG commit
```