mirror of
https://github.com/danbulant/flying-squid
synced 2026-06-15 20:41:14 +00:00
97 lines
2.8 KiB
Markdown
97 lines
2.8 KiB
Markdown
# Contribute
|
|
|
|
## Architecture of the project
|
|
|
|
Directory architecture :
|
|
|
|
* app.js: specific settings and actually start the server
|
|
* index.js: contain the generic server implementation
|
|
* lib/: contain the classes and functions used in the plugins
|
|
* serverPlugins/: server plugins that do things general to the server,
|
|
properties and method are added to the server object in them
|
|
* playerPlugins/: player plugins that do things for each player, properties and method are added to the player object in them
|
|
|
|
Structure of a server plugin:
|
|
|
|
```js
|
|
module.exports=inject;
|
|
|
|
function inject(serv)
|
|
{
|
|
// add methods and properties to serv
|
|
}
|
|
```
|
|
|
|
Structure of a player plugin :
|
|
|
|
```js
|
|
module.exports=inject;
|
|
|
|
function inject(serv,player)
|
|
{
|
|
// add methods and properties to player
|
|
// you can use serv, but you shouldn't add things to it here
|
|
}
|
|
```
|
|
|
|
## Logs and event
|
|
|
|
In order to keep logging independent from the rest of the server and to let people react in other ways than logging,
|
|
server and player events should be emitting and the logging should only take place in response to these events
|
|
in log.js of playerPlugins or serverPlugins.
|
|
|
|
## Creating external plugins
|
|
|
|
Create a new repo, which will be published to npm when ready to be used.
|
|
|
|
Create a file in which you put an inject function like this :
|
|
|
|
```js
|
|
module.exports=init;
|
|
|
|
function init(flying-squid) {
|
|
return inject;
|
|
}
|
|
|
|
function inject(serv)
|
|
{
|
|
// add methods and properties to serv
|
|
}
|
|
```
|
|
|
|
In the init function, you can use anything flying-squid provide
|
|
(see [index.js](https://github.com/mhsjlw/flying-squid/blob/master/index.js#L11)).
|
|
|
|
In the inject function you can use everything documented in the [api.md](api.md) to add functionalities to the serv object.
|
|
|
|
Let's say you called your module flying-horses and you published it to npm.
|
|
|
|
Now people can use your plugin that way :
|
|
|
|
```js
|
|
var flyingSquid = require('flying-squid');
|
|
var flyingHorses = require('flying-horses')(flyingSquid);
|
|
var serv = flyingSquid.createMCServer(/* your options there */);
|
|
// install the plugin
|
|
flyingHorses(serv);
|
|
```
|
|
|
|
As explained in the first part of this file, flying-squid has 2 kinds of plugins: server plugins, and player plugins.
|
|
We've explained until now how to create a server plugin and to use it with flying-squid.
|
|
|
|
Within the same module, you can also create a player plugin. Here is the code you need to add to do that:
|
|
|
|
```js
|
|
serv.on("newPlayer",function(player){
|
|
injectPlayer(serv,player);
|
|
});
|
|
|
|
function injectPlayer(serv,player)
|
|
{
|
|
// add methods and properties to player
|
|
// you can use serv, but you shouldn't add things to it here
|
|
}
|
|
```
|
|
|
|
In this document, we explained how to create a simple plugin with just one file, but you can cut your code
|
|
in several files by having several inject function and putting them in different files, just like flying-squid does for its internal plugins.
|