NOTE: This short guide is for a C3, 3.0.0 release of L2J Server.
====================
L2J Server v3.0.0
====================
$Date: 2005/09/07 22:17:35 $
$Revision: 2.0 $
TOC:
I. OVERVIEW
II. REQUIREMENTS
III. FIRST STARTUP
IV. ADMIN/GM's GUIDE
V. PLAYER's GUIDE
VI. UPDATING
VII. TROUBLESHOOTING
VIII. LEGAL
IX. CONTACT
X. CONTRIBUTING
XI. BUG REPORTING
XII. CREDITS
====================
I. OVERVIEW
====================
L2J is an Alternative Lineage 2 Game Server written in pure Java for
best compatibility. L2J gives you the possibility to legally host a game
server for this popular Korean MMO created by NCSoft. It is still
unfinished and many features are missing, but L2J Dev team is working
hard on implementing them. L2J Server is distributed under the terms
of GNU/GPL in a hope that open source model is the best for
developing quality software giving everyone a possibility to
participate on development by submitting the code.
====================
II. REQUIREMENTS
====================
OS:
Any OS having Java JDK 1.5 installed and properly configured!
We recommend using SUN JDK available at java.sun.com
Hardware:
Decent CPU & RAM
Software:
Java JDK 1.5
MySql
Datapack
====================
III. FIRST STARTUP
====================
Before you can start up the server please read the wiki sites.
They contain all the info you need to setup and run a L2J Server.
L2J Server wiki: Server Guides, How-to's, bugtracker:
https://opensvn.csie.org/traccgi/l2j/trac.cgi/wiki
L2J-Datapack wiki: Datapack Guides, How-to's, bugtracker:
https://opensvn.csie.org/traccgi/L2J_Datapack/trac.cgi/wiki
L2J Community wiki: Guides, How-to's:
http://l2j.jot.com
This Server distribution does not contain any spawn/drop data or any world
content. (Datapack)
L2J Server has also a possibility to change xp/sp/drop rates relative
to data in spawnlist/droplist files. To do that, just change the rates
you need in server.properties file found in config folder.
You should also configure your IP address in server.properties.
Server uses ports 2106 (LoginServer) and 7777 (GameServer) by
default. If your server runs behind NAT or firewall you will need to
open and/or forward these ports.
====================
IV. ADMIN/GM's GUIDE
====================
To make someone an admin you need to edit, in the l2jdb database, the desired character in the
characters table, while server is SHUT DOWN! Change the field, accesslevel from 0 to 100 or more.
You may start server after that and the person will have admin privileges.
Note that you must create the account and character before editing.
Possible access levels:
-100 = banned
0 = normal account/character
51 or more = exempt from maximum connections limit (accounts table only)
100 or more = admin
More info can be found in the community wiki.
Admin commands implemented:
(Please see https://opensvn.csie.org/traccgi/l2j/trac.cgi/wiki/GmCommands for more complete list.)
//admin = main GM interface
//gmchat = will send a message to all online GMs
//invul = makes our character untouchable
====================
V. PLAYER's GUIDE
====================
CLIENT COMPATIBILITY
L2J v3.0.0 should be compatible with any Chronicle 3 client with revision 551
or higher.
====================
VI. UPDATING
====================
It may arrive that you want to update your server to new version while
keeping old accounts. There are few steps you HAVE TO do in order to
keep the data accurate.
- You should ALWAYS look at timelines before updating, sometimes a file
format may change, so you will need to edit data manually to fit with
new format.
- You should ALWAYS Backup all MySql data.
- You should ALWAYS Backup all Server and Datapack files.
- back up all .properties files (don't forget to check if new server use same
format for those files)
- download & unzip new server code to the Server directory
- download & unzip new datapack code to the Server directory
- edit and run update in the tools folder
- run newly installed server & enjoy ;)
====================
VII. TROUBLESHOOTING
====================
PROBLEM
- Client outputs bunch of messages about missing templates.
SOLUTION
- Check that the datapack has been properly installed.
PROBLEM
- Message similar to "java is not recognized as internal command",
"java not found" or "unknown command: java" appears.
SOLUTION
- Install java, or, if java is already installed just add your java
binary directory to system PATH setting. If you don't know how to do
that, than DO NOT bother running your own server please.
PROBLEM
- I can log in but ping is 9999s and I can't get past Server Select.
SOLUTION
- Set up your IP's properly, forward/open good ports if accessing from
outside. (or find server with admin that knows how to do it)
PROBLEM
- Skills/quests/whatever don't work.
SOLUTION
- Patience brings it's fruits :p
PROBLEM
- I found a bug.
SOLUTION
- Please refer to BUG REPORTING section of this readme.
Further help available at the wiki sites and the forums.
====================
VIII. LEGAL
====================
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307,
USA.
Full GNU/GPL License is included in LICENSE.TXT file.
Whereas L2J is distributed under the terms of GNU/GPL, we will be
happy if you:
a) Preserve logon notice. This give us, L2J Developers, appropriate
credit for our hard work done during our free time without any
revenues.
b) Do not distribute any extended data files with the server files in
the same archive. NO world content should be incorporated in L2J
distribution.
====================
IX. CONTACT
====================
Web: http://l2j.sourceforge.net
IRC: #l2j @ Freenode (irc.freenode.net)
Please note that L2J Devs can't help players with connecting issues or
anything related to playing on private servers. If you can't connect,
you should contact your server GM's. We can solve only L2J server
~software~ related issues. We don't have any backdoors or anything
that would enable us GM accounts on every server using L2J, so there's
no point in coming to our channel if you need items/adena/whatever
ingame.
====================
X. CONTRIBUTING
====================
Anyone who want to contribute to project is encouraged to do so. Java
programming skills are not always required as L2J needs much more than
java code.
If you created anything that may be helpful use User Contributions
section on our forums. If you contributed good stuff that will be
accepted, you might be invited to join L2J Dev Team.
People willing to hang on chat and respond to user questions are also
ALWAYS welcome ;)
====================
XI. BUG REPORTING
====================
Bugs can be reported on our wiki site.
https://opensvn.csie.org/traccgi/l2j/trac.cgi/newticket
Basic rules for reporting are:
Please report only one bug/issue per ticket!!
You must include the revision (changeset) number when reporting a bug!
"The latest" does not mean anything when 5 more updates have been done since you set up the server.
If you are not sure if it should be reported here, make a post about it in the L2J forum.
Players should ALWAYS consult bugs with their GM's before reporting it
on our wiki site. Some bugs may be caused by bad datapack, server
installation or modification server owner has made. We can't help you
in that case.
Please use the datapacks bugtracker for reporting datapack bugs.
Please do NOT report bugs related to unofficial add-ons to L2J. L2J
bugtracker is NOT a place to fix that. Contact the person who made
modification instead.
====================
XII. CREDITS
====================
Dev team:
Project Managers:
L2Chef
Agelian/Luis Antonioa
Project Developers:
Active:
Drakin-Korin
Eloquence
Juokelis
Sh1ny
Galun
Lithium
Godson
Thorgrim
ootz0rz
Dalrond
Balancer
Mr/roberto28[kns]
Unleashed/L2Unleashed
NeXuS
TempyIncursion
MickyLee
Niedar
Wooden/WoodenGil
Inactive
Maximas/Mk2
Tenkawa ?
Whatev ?
Natiels ?
Warrax
Sarevok
Myrdos
Delicioso
Reich
v00d00
Undeady/Lilium
Project Forum Adminstrators:
Agelian/Luisantonioa
L2Chef
Drakin-Korin
Nuocnam
Project Forum Moderators:
Kadar
Madmalkav
Warrax
Juokelis
Eloquence
Have fun playing Lineage II ;)
Dev Team