From 8acbd8ddeabbe2a27ac1653933516f55f6f15c38 Mon Sep 17 00:00:00 2001 From: gumi Date: Fri, 21 Sep 2018 11:36:32 -0400 Subject: simplify windows installation instructions --- README.md | 18 +++++++++++++----- 1 file changed, 13 insertions(+), 5 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index f334b7862..1d449dc99 100644 --- a/README.md +++ b/README.md @@ -54,8 +54,6 @@ Platforms](https://github.com/HerculesWS/Hercules/wiki/Supported-Platforms) wiki #### Windows - Git client - - MySQL-compatible server ([MySQL Community Edition](https://www.mysql.com/products/community/) or - [MariaDB](https://mariadb.org/)) - Microsoft Visual Studio ([Version 2012 through 2015](https://www.visualstudio.com/)) #### Unix/Linux/BSD (names of packages may require specific version numbers on certain distributions) @@ -96,16 +94,26 @@ guides relevant to your Operation System, please refer to the Wiki (links at the end of this file). #### Windows +##### Easy installation 1. Install the prerequisites. 2. Clone the Hercules repository (see [GitHub](https://github.com/HerculesWS/Hercules)) using a git client, into a new folder. - 3. Connect to the MySQL server as root: + - If you do not want to use the command line, you can also clone with [GitHub Desktop](https://desktop.github.com/). + 3. Run `mariadb.bat` to automatically install and configure MariaDB. + 4. Start Visual Studio and load the provided solution: + - Compile and run the three projects, login-server, char-server, map-server. +##### Manual installation + 1. Install the prerequisites. + 2. Install a MySQL-compatible server, such as [MariaDB](https://mariadb.org/) (recommended) or [MySQL Community Edition](https://www.mysql.com/products/community/) + 3. Clone the Hercules repository (see [GitHub](https://github.com/HerculesWS/Hercules)) using a git client, into a new + folder. + 4. Connect to the MySQL server as root: - Create a database (hercules): `CREATE DATABASE hercules;` - Create a user (hercules): `CREATE USER 'hercules'@'localhost' IDENTIFIED BY 'password';`. - Give permissions (GRANT SELECT,INSERT,UPDATE,DELETE) to the user: `GRANT SELECT,INSERT,UPDATE,DELETE ON hercules.* TO 'hercules'@'localhost';` - 4. Connect to the MySQL server as the new user: + 5. Connect to the MySQL server as the new user: - Import the .sql files in /sql-files/ into the new database. - 5. Start Visual Studio and load the provided solution: + 6. Start Visual Studio and load the provided solution: - Compile and run the three projects, login-server, char-server, map-server. #### Unix -- cgit v1.2.3-70-g09d2 From 9813890b1b0e9dfe1e795c4bcd7fbb0d9cfb7131 Mon Sep 17 00:00:00 2001 From: gumi Date: Wed, 7 Nov 2018 14:43:52 -0500 Subject: freshen the README further --- README.md | 65 ++++++++++++++++++++++++++++++++++++--------------------------- 1 file changed, 37 insertions(+), 28 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 1d449dc99..4d6841491 100644 --- a/README.md +++ b/README.md @@ -49,12 +49,11 @@ Before installing Hercules, you will need to install certain tools and applicati This differs between the varying Operating Systems available, so the following list is broken down into Windows and Unix (incl. Linux) prerequisites. -For a list of supported platforms, please refer to the [Supported -Platforms](https://github.com/HerculesWS/Hercules/wiki/Supported-Platforms) wiki page. +For a list of supported platforms, please refer to the [Supported Platforms](https://github.com/HerculesWS/Hercules/wiki/Supported-Platforms) wiki page. #### Windows - - Git client - - Microsoft Visual Studio ([Version 2012 through 2015](https://www.visualstudio.com/)) + - [Git client](https://git-scm.com/) + - [Microsoft Visual Studio Community](https://visualstudio.microsoft.com/vs/community/) #### Unix/Linux/BSD (names of packages may require specific version numbers on certain distributions) - git @@ -80,10 +79,20 @@ Platforms](https://github.com/HerculesWS/Hercules/wiki/Supported-Platforms) wiki - MySQL GUI clients - [MySQL Workbench](http://www.mysql.com/downloads/workbench/) (cross-platform) - [HeidiSQL](http://www.heidisql.com/) (Windows) + - [DBeaver](http://dbeaver.jkiss.org/) (cross-platform) - [Sequel Pro](http://www.sequelpro.com/) (Mac OS X) + - *More options available at [mariadb.com](https://mariadb.com/kb/en/library/graphical-and-enhanced-clients/)* - GUI Git clients + - [GitHub Desktop](https://desktop.github.com/) (cross-platform) + - [GitKraken](https://www.gitkraken.com/git-client) (cross-platform) + - [SmartGit](https://www.syntevo.com/smartgit/) (cross-platform) - [Atlassian SourceTree](https://www.sourcetreeapp.com/) (Windows, Mac OS X) - - [TortoiseGit](https://tortoisegit.org/) (Windows) + - *More options available at [git-scm.com](https://git-scm.com/downloads/guis)* + - Text editors with syntax highlighting + - [Visual Studio Code](https://code.visualstudio.com) (cross-platform) + - [Atom](https://atom.io) (cross-platform) + - [Notepad++](https://notepad-plus-plus.org) (Windows) + - *More options available at [wikipedia.org](https://en.wikipedia.org/wiki/Comparison_of_text_editors#Overview)* Installation @@ -96,47 +105,47 @@ the end of this file). #### Windows ##### Easy installation 1. Install the prerequisites. - 2. Clone the Hercules repository (see [GitHub](https://github.com/HerculesWS/Hercules)) using a git client, into a new + 2. Clone the [Hercules repository](https://github.com/HerculesWS/Hercules) using a git client, into a new folder. - - If you do not want to use the command line, you can also clone with [GitHub Desktop](https://desktop.github.com/). + - If you do not want to use the command line, you can instead clone with [GitHub Desktop](https://desktop.github.com/). 3. Run `mariadb.bat` to automatically install and configure MariaDB. 4. Start Visual Studio and load the provided solution: - - Compile and run the three projects, login-server, char-server, map-server. + - Compile and run the three projects, login-server, char-server, map-server. ##### Manual installation 1. Install the prerequisites. 2. Install a MySQL-compatible server, such as [MariaDB](https://mariadb.org/) (recommended) or [MySQL Community Edition](https://www.mysql.com/products/community/) - 3. Clone the Hercules repository (see [GitHub](https://github.com/HerculesWS/Hercules)) using a git client, into a new + 3. Clone the Hercules repository [Hercules repository](https://github.com/HerculesWS/Hercules) using a git client, into a new folder. 4. Connect to the MySQL server as root: - - Create a database (hercules): `CREATE DATABASE hercules;` - - Create a user (hercules): `CREATE USER 'hercules'@'localhost' IDENTIFIED BY 'password';`. - - Give permissions (GRANT SELECT,INSERT,UPDATE,DELETE) to the user: `GRANT SELECT,INSERT,UPDATE,DELETE ON hercules.* TO 'hercules'@'localhost';` + - Create a database (hercules): `CREATE DATABASE hercules;` + - Create a user (hercules): `CREATE USER 'hercules'@'localhost' IDENTIFIED BY 'password';`. + - Give permissions (GRANT SELECT,INSERT,UPDATE,DELETE) to the user: `GRANT SELECT,INSERT,UPDATE,DELETE ON hercules.* TO 'hercules'@'localhost';` 5. Connect to the MySQL server as the new user: - - Import the .sql files in /sql-files/ into the new database. + - Import the .sql files in /sql-files/ into the new database. 6. Start Visual Studio and load the provided solution: - - Compile and run the three projects, login-server, char-server, map-server. + - Compile and run the three projects, login-server, char-server, map-server. #### Unix 1. Install the prerequisites through your distribution's package manager - - (Red Hat compatible / CentOS) `yum install gcc make mysql mysql-devel mysql-server pcre-devel zlib-devel git` - - (Debian compatible) `apt-get install gcc make libmysqlclient-dev zlib1g-dev libpcre3-dev mysql-server git` - - (FreeBSD) `pkg install clang35 gmake mysql56-server mysql-connector-c pcre git` - - (Mac OS X): - - Install Xcode through the Mac App Store - - Initialize the build tools through the Terminal `xcode-select --help` - - Install Homebrew as described on the project page - - Install the other prerequisites: `brew install mysql pcre` + - (Red Hat compatible / CentOS) `yum install gcc make mysql mysql-devel mysql-server pcre-devel zlib-devel git` + - (Debian compatible) `apt-get install gcc make libmysqlclient-dev zlib1g-dev libpcre3-dev mysql-server git` + - (FreeBSD) `pkg install clang35 gmake mysql56-server mysql-connector-c pcre git` + - (Mac OS X): + - Install Xcode through the Mac App Store + - Initialize the build tools through the Terminal `xcode-select --help` + - Install Homebrew as described on the project page + - Install the other prerequisites: `brew install mysql pcre` 2. Clone the Hercules repository `git clone https://github.com/HerculesWS/Hercules.git ~/Hercules` 3. Configure the MySQL server and start it. 4. Connect to the MySQL server as root: - - Create a database (hercules): `CREATE DATABASE hercules;` - - Create a user (hercules): `CREATE USER 'hercules'@'localhost' IDENTIFIED BY 'password';`. - - Give permissions (GRANT SELECT,INSERT,UPDATE,DELETE) to the user: `GRANT SELECT,INSERT,UPDATE,DELETE ON hercules.* TO 'hercules'@'localhost';` + - Create a database (hercules): `CREATE DATABASE hercules;` + - Create a user (hercules): `CREATE USER 'hercules'@'localhost' IDENTIFIED BY 'password';`. + - Give permissions (GRANT SELECT,INSERT,UPDATE,DELETE) to the user: `GRANT SELECT,INSERT,UPDATE,DELETE ON hercules.* TO 'hercules'@'localhost';` 5. Connect to the MySQL server as the new user: - - Import the .sql files in /sql-files/ into the new database. + - Import the .sql files in /sql-files/ into the new database. 6. Enter the Hercules directory and configure/build Hercules - - `./configure` - - `make clean && make sql` (on FreeBSD, replace `make` with `gmake`) + - `./configure` + - `make clean && make sql` (on FreeBSD, replace `make` with `gmake`) 7. Start the three servers login-server, char-server, map-server. Troubleshooting -- cgit v1.2.3-70-g09d2 From c6656e3a36a132b8342b4d7b8bab4e7f7e52331a Mon Sep 17 00:00:00 2001 From: Gabriel Mejia Date: Mon, 21 Jan 2019 17:22:12 -0500 Subject: Update README.md added links into readme.md --- README.md | 27 ++++++++++++++------------- 1 file changed, 14 insertions(+), 13 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 1798bf394..2cc75b250 100644 --- a/README.md +++ b/README.md @@ -29,14 +29,15 @@ Project Info: Table of Contents --------- -1. What is Hercules? -2. Prerequisites -3. Installation -4. Troubleshooting -5. Helpful Links -6. More Documentation - -What is Hercules? +1. [What is Hercules?](#what-is-hercules) +2. [Prerequisites](#prerequisites) +3. [Installation](#installation) +4. [Troubleshooting](#troubleshooting) +5. [Helpful Links](#helpful-links) +6. [More Documentation](#more-documentation) + + +## What is Hercules? ----------------- Hercules is a collaborative software development project revolving around the creation of a robust Massively Multiplayer Online Role-Playing Game (MMORPG) @@ -45,7 +46,7 @@ warps and modifications. The project is jointly managed by a group of volunteers located around the world as well as a tremendous community providing QA and support. Hercules is a continuation of the original Athena project. -Prerequisites +## Prerequisites ------------- Before installing Hercules, you will need to install certain tools and applications. This differs between the varying Operating Systems available, so the @@ -90,7 +91,7 @@ Platforms](https://github.com/HerculesWS/Hercules/wiki/Supported-Platforms) wiki - [TortoiseGit](https://tortoisegit.org/) (Windows) -Installation +## Installation ------------ This section is a very brief set of installation instructions. For more concise @@ -133,7 +134,7 @@ the end of this file). - `make clean && make sql` (on FreeBSD, replace `make` with `gmake`) 7. Start the three servers login-server, char-server, map-server. -Troubleshooting +## Troubleshooting --------------- If you're having problems with starting your server, the first thing you should @@ -179,7 +180,7 @@ Examples: If this shows up on the map server, it generally means that there is no Char Server available to accept the connection. -Helpful Links +## Helpful Links ------------- The following list of links point to various help files within the repository, @@ -198,7 +199,7 @@ articles or pages on the Wiki or topics within the Hercules forum. Network: `irc.rizon.net` Channel: `#Hercules` -More Documentation +## More Documentation ------------------ Hercules has a large collection of help files and sample NPC scripts located in -- cgit v1.2.3-70-g09d2 From 6b13e76a1ff24d465ab3f42fde284b2231f4cb61 Mon Sep 17 00:00:00 2001 From: Jedzkie Date: Sun, 21 Apr 2019 10:30:12 +0800 Subject: Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'README.md') diff --git a/README.md b/README.md index 2cc75b250..b17eedbda 100644 --- a/README.md +++ b/README.md @@ -149,7 +149,7 @@ Examples: [Error]: npc_parsesrcfile: Unable to parse, probably a missing or extra TAB in file 'npc/custom/jobmaster.txt', line '17'. Skipping line... * w1=prontera,153,193,6 script * w2=Job Master - * w3=123,{ + * w3=2_F_MAGICMASTER,{ * w4= ``` -- cgit v1.2.3-70-g09d2