AstralTransRocketries/ClassiCube
1
0
Fork 0
mirror of https://github.com/ClassiCube/ClassiCube.git synced 2025-09-12 09:06:55 -04:00
Code Issues Packages Projects Releases Wiki Activity

Fix example plugin instructions not compiling

Browse Source
This commit is contained in:
UnknownShadow200 2021-10-10 20:09:31 +11:00 committed by GitHub
parent 93d47a9e0c
commit 28893886d4
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 10 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
doc/plugin-dev.md
View File

@ -21,7 +21,8 @@ Or in other words, in a directory somewhere, you have a file named ```TestPlugin
### Basic plugin
```C
#include "src/Chat.h"
#include "src/GameStructs.h"
#include "src/Game.h"
#include "src/String.h"
static void TestPlugin_Init(void) {
cc_string msg = String_FromConst("Hello world!");
@ -35,10 +36,7 @@ Here's the idea for a basic plugin that shows "Hello world" in chat when the gam
### Basic plugin boilerplate
```C
#include "src/Chat.h"
#include "src/Game.h"
#ifdef CC_BUILD_WIN
#ifdef _WIN32
#define CC_API __declspec(dllimport)
#define CC_VAR __declspec(dllimport)
#define EXPORT __declspec(dllexport)
@ -48,6 +46,10 @@ Here's the idea for a basic plugin that shows "Hello world" in chat when the gam
#define EXPORT __attribute__((visibility("default")))
#endif
#include "src/Chat.h"
#include "src/Game.h"
#include "src/String.h"
static void TestPlugin_Init(void) {
cc_string msg = String_FromConst("Hello world!");
Chat_Add(&msg);
@ -62,16 +64,17 @@ All plugins require this boilerplate, so feel free to copy and paste it.
---
### Writing plugins in C++
When including game headers, they must be surrounded with `extern "C"`, i.e.
When including headers from ClassiCube, they **must** be surrounded with `extern "C"`, i.e.
```C
extern "C" {
#include "src/Chat.h"
#include "src/Game.h"
#include "src/String.h"
}
```
Otherwise you will get obscure `Undefined reference` errors when compiling.
Exported plugin functions must be surrounded with `extern "C"`, i.e.
Exported plugin functions **must** be surrounded with `extern "C"`, i.e.
```C
extern "C" {
EXPORT int Plugin_ApiVersion = 1;