Grasscutter/README_fil-PH.md

EN | 简中 | 繁中 | FR | ES | HE | RU | PL | ID | KR | FIL/PH | NL | JP

Atensyon: Ang mga kontributor ay laging welcome sa proyektong ito. Bago mag-bigay ng kontribusyon, basahin muna ng mabuti ang Code of Conduct.

Ang mga kasalukuyang features

• Logging in
• Combat
• Friends list
• Teleportation
• Gacha system
• Co-op partially works
• Spawning monsters via console
• Inventory features (receiving items/characters, upgrading items/characters, etc)

Quick setup guide

Atensyon: Para sa mga nangangailangan ng suporta, maaari kang sumali sa aming server Discord.

Ang mga kailangan

• Java SE - 17 or higher

  Atensyon: Kung gusto mo lang paganahin ang server, pwede naman ang jre.

• MongoDB (recommended 4.0+)

• Proxy Daemon: mitmproxy (mitmdump, recommended), Fiddler Classic, etc.

Running

Atensyon: Kung nag-update ka galing sa lumang version, paki-delete ang config.json para mag-regenerate ulit.

1. Get grasscutter.jar
   • I-download mo sa releases o sa actions o bumuo ng iyong sariling server.
2. Gawa ka ng resources folder sa directory kung nasaan ang grasscutter.jar at ilagay ang BinOutput, ExcelBinOutput, Readables, Scripts, Subtitle, TextMap folders sa loob ng resources folder (Tingnan mo ang wiki para malaman mo kung saan mo makukuha yan)
3. Paandarin ang Grasscutter gamit ang command na java -jar grasscutter.jar. Siguraduhin mo na ang mongodb service ay naka-open din.

Connecting with the client

½. Gumawa ng account sa server console gamit ang command na ito.

1. Redirect traffic: (pumili lang dapat ng isa)

   • mitmdump: mitmdump -s proxy.py -k

     • Trust CA certificate:

       • Ang CA certificate ay nasa %USERPROFILE%\.mitmproxy, i-double click ang mitmproxy-ca-cert.cer para ma-install o...

       • Via command line (kailangan ng administration privileges)

         certutil -addstore root %USERPROFILE%\.mitmproxy\mitmproxy-ca-cert.cer
         

   • Fiddler Classic: Paadarin ang Fiddler Classic, turn on mo yung Decrypt https traffic sa (Tools -> Options -> HTTPS) at baguhin mo ang default port na nakalagay (Tools -> Options -> Connections) sa anumang numero maliban sa 8888, i-load ang script na ito (copy and paste ang script sa FiddlerScript tab) at i-click ang Save Script button.

   • Hosts file

2. Set mo ung proxy sa 127.0.0.1:8080 or dun sa proxy port na iyong inilagay.

• Para sa mitmproxy: Pagkatapos mong i-setup ang network proxy at sa pag-install ng certificate, tingnan mo sa http://mitm.it/ kung ang traffic ay dumadaan sa mitmproxy.

Pwede mo rin gamitin ang start.cmd to start the servers and proxy daemons automatically, pero kailagan mong i-setup ang JAVA_HOME environment at i-configure ang start_config.cmd file.

Building

Ang Grasscutter ay gumagamit ng Gradle para sa depedencies at building.

Mga kailangan:

• Java SE Development Kits - 17 or higher
• Git

Windows

git clone https://github.com/Grasscutters/Grasscutter.git
cd Grasscutter
.\gradlew.bat # Setting up environments
.\gradlew jar # Compile jar

Linux

git clone https://github.com/Grasscutters/Grasscutter.git
cd Grasscutter
chmod +x gradlew
./gradlew jar # Compile jar

Pag-katapos mong i-compile, check mo yung project directory at makikita mo yung jar na kinompile mo. Usually pag-dev version, ang dapat nakalagay diyan ay grasscutter-<version>-dev.jar.

Ang mga server commands ay nasa wiki na!

Quick Troubleshooting

• Kung hindi nag-compile, paki-check ung JDK installation mo (JDK 17 at JDK's bin PATH variable).
• Hindi ako maka-connect, ayaw mag-login, 4206, etc... - Mostly ang proxy setup mo ang may kasalanan niyan, kung gamit mo ay Fiddler, paki-sigurado na naka-set ung port sa kahit ano except sa 8888.
• Ang pagkakasunud-sunod: MongoDB > Grasscutter > Proxy Daemon (mitmdump, fiddler, etc.) > Game