Download Link:
https://runeindex.com/drive/s/loyDj927AyfXOYw6DySeZSfGSjayE6
Tools:
N\A
Introduction
Apollo is a RuneScape emulator which aims to encourage a fundamentally-different alternative to the way in which private server development is done today. It consists of a high-performance, modular server written in Java as well as a collection of utilities for managing the data files and plugins.
Plugins
Currently people download a server, read through tutorials and apply their modifications or write their own code on top of it. They'll then host it or release it. The result is we currently have a complete mess of servers (this includes every current base - Hyperion, rs2hd, winterlove) all created from cobbled-together code.
Apollo is going to change that through its plugin system. Instead of throwing everything into one big application, Apollo consists of:
A small 'core' application which provides features necessary for the server to operate.
A set of plugins, and the tools to manage them (install, uninstall, publish, download, etc).
Some additional tools and utilities for managing the data files.
This will make it much easier for everyone to develop a private server, no longer restricting it to people who can (or can't as the case is here) program. Instead of messing around copying and pasting lines of code from a woodcutting tutorial, people will simply have to download and install a woodcutting plugin.
There is also a plan to have a plugin repository (or maybe multiple repositories) and a set of tools to make the experience very much like a package manager on Linux.
It also means updates can be provided for the core server (e.g. security, stability, optimizations) very easily. Users will just have to download the new jar, overwrite the current one with the new one, and reboot their server.
And best of all, inexperienced users are protected from making fatal mistakes in the core and are kept away from stuff that they shouldn't be editing at their experience level.
Plugins are currently written in Ruby, however, in the future other languages could be added. Here is what a plugin looks like:
hello.rb:
Code:
require 'java'
java_import 'org.apollo.game.model.Animation'
on :command, :hello do |player, command|
player.play_animation Animation::WAVE
player.send_message "Hello, World!"
end
plugin.xml:
Code:
<?xml version="1.0"?>
<plugin>
<id>hello</id>
<version>1</version>
<name>Hello World Command</name>
<description>Adds a ::hello command which simply prints 'Hello, World!'.</description>
<authors>
<author>Graham</author>
</authors>
<scripts>
<script>hello.rb</script>
</scripts>
<dependencies />
</plugin>
Core Features
Some of the significant (technically) current core features include:
Packet encoding/decoding has been split from the representations of the packets themselves. This allows the potential for encoding/decoding to go on in parallel and also allows multiple revisions to be supported. Currently 317 and 377 are both completely supported.
Update server support (JAGGRAB, ondemand and HTTP).
Packet handler chaining: this allows multiple plugins to be able to intercept a single packet and deal with it appropriately. For example, a quest plugin could intercept searching a bookshelf for instance, if the behaviour needed to change in certain cases.
Parallel execution of player updating for multi-core machines - this has a significant benefit on my dual core machine used to test the server.
As well as that, it has the bog standard stuff:
Login
Appearance updating
Multiplayer
Walking/running
Rights management
Travel back algorithm for movement
Character design
Chatting
Commands
Inventory support
Equipment support
Animations
Graphics
Facing/turn to
Action system
Working distanced actions
All data types implemented
Task scheduler based on game ticks
Saving/loading with a custom binary format
Skill levels/experiences
Plugin management
Reads item information from the cache
Plugin features
These are the current plugins that I've developed so far.
hello: a 'hello world' plugin just to demonstrate how they are used for plugin developers.
cmd-item: item-related commands: item, destroy and empty
cmd-skill: skill-related commands: max
cmd-teleport: teleport/position-related commands: pos, tele
dummy: the dummies in Varrock
mining: a mining plugin to demonstrate a larger plugin for future plugin developers, and to test some of the newer features (not yet completed)
Source control/building
Currently the repository is private (it isn't ready yet, and will not be released until it is ready!).
Server architecture
Third-party libraries
The server uses the Netty API for the networking code. Netty supports a variety of transports such as NIO and blocking IO, so you can choose what is right for your environment/use case.
The Commons Compress library is used for decompressing bzip2-compressed files in the cache.
The JUnit library is used for unit testing.
The JRuby library is used to execute the Ruby plugins.
APIviz is used to draw pretty diagrams in the Javadocs.
Media
Mining/prospecting plugin:
Wielding items:
Real 377 support:
Skill levels:
Testing the hello plugin:
Benchmarks
These are quite out of date and I will get around to redoing them at some point on a variety of platforms/configurations!
These are from a 32 bit machine running Windows 7. It has a dual core 2.2 ghz processor and 2 GB of RAM. Java 1.7.0-ea was used with the HotSpot Server VM.
Parallel updater:
The cycle time with 2000 idle players took 240-270ms (later improved to 140-160ms). The cycle time with 2000 players spamming chat messages was 420-470ms.
Sequential updater:
The cycle time with 2000 idle players took 290-340ms. With the players spamming chat messages it took 550-700ms.
Using the parallel updater (recommended for the PC since it has multiple cores), the performance was well within the 600ms limit. It isn't amazing hardware either.
Current Plans
The plan roughly is:
Get the core finished to a usable state for plugin developers.
Allow a select number of people early access in order for them to develop open-source plugins accurate to RuneScape. Finish developing the core while this goes on.
Release the core and all the plugins simultaneously.
Sit back and do occasional updates to the core. The community can do the rest.
Credits
blakeman8192
Sir Sean
super_
wL
daiki
Saevion
popcorn89
Tom
defyboy
silabsoft
thiefmn6092
Phyfiox (aka Raul)
Scu11
Palidino76
Parabolika