前言介紹
- 這款 WordPress 外掛「Adventurebook」是 2025-09-30 上架。
- 目前有 10 個安裝啟用數。
- 上一次更新是 2025-11-06，距離現在已有 113 天。
- 外掛最低要求 WordPress 5.2 以上版本才可以安裝。
- 外掛要求網站主機運作至少需要 PHP 版本 7.2 以上。
- 尚未有人給過這款外掛評分。
- 還沒有人在論壇上發問，可能目前使用數不多，還沒有什麼大問題。
外掛協作開發者
icetear |
外掛標籤
adventure | storybook | interactive | storytelling | adventurebook |
內容簡介
### 摘要
Adventurebook 是一款 WordPress 外掛，讓您可以在您的 WordPress 網站上創建互動式故事書或類似角色扮演的冒險書。透過 Adventurebook，您可以打造引人入勝的敘事，讓讀者的選擇影響故事結局。
### 重點特色
- 互動式故事：創建具有多條路徑和結局的故事，基於讀者的選擇。
- 簡便易用的界面：使用者友好的工具，設計和管理您的冒險書。
- 可定制選項：調整冒險書的外觀和功能，以適應您的風格。
- 多媒體支持：使用圖像增強您的故事。
- 響應式設計：確保您的冒險書在所有設備上都能表現出色。
### 如何使用
1. 啟用外掛後，在您的 WordPress 控制面板中找到「冒險書」選單。
2. 點擊「新增冒險書」，開始創建您的冒險書。
3. 使用編輯器添加頁面、選擇和多媒體元素到您的書中。
4. 發布您的冒險書並與觀眾分享！
5. 使用短碼 [adventurebook id="X"]（其中 X 為您的冒險書的 ID）將書嵌入到任何頁面或文章。
6. 使用「書頁」選單創建書頁。
7. 通過在冒險書編輯頁面上選擇您選擇的書頁來設置起始頁面。
### 如何設定遊戲類型的冒險書
1. 使用短碼 [adventurebook_character_overview] 創建一個角色管理頁面。
2. 在 Adventurebook 設置中設定這個頁面（WordPress 管理員 - Settings - Adventurebook）。
3. 創建一個新的類型為「遊戲」的冒險書。
4. 使用短碼 [adventurebook id="X"] 創建書專頁，其中 X 為您的冒險書的 ID。
5. 這本冒險書將被嵌入到此頁面中。
6. 在「冒險書項目」選單中創建物品。
7. 創建書頁並將物品生成到頁面中。
8. 通過在冒險書編輯頁面上選擇您選擇的書頁來設置起始頁面。
原文外掛簡介
Adventurebook is a plugin that allows you to create interactive storybooks or roleplay-like adventure books on your WordPress site. With Adventurebook, you can craft engaging narratives where readers can make choices that influence the outcome of the story.
Key Features:
Interactive Storytelling: Create stories with multiple paths and endings based on reader choices.
Easy-to-Use Interface: User-friendly tools to design and manage your adventure books.
Customizable Options: Tailor the appearance and functionality of your adventure books to fit your style.
Multimedia Support: Enhance your stories with images. Add audio to pages that will be played automatically when the page is loaded (if your browser permits).
Character and Item Management: For “Game”-type Adventurebooks, manage items and creatures that characters can interact with.
Combat System: A simple turn-based combat system for “Game”-type Adventurebooks, allowing characters to engage with creatures.
Script Editor: Create custom scripts to add dynamic elements to your adventure books.
Responsive Design: Ensure your adventure books look great on all devices.
Whether you’re an author looking to publish interactive stories or a teacher wanting to create engaging learning materials, Adventurebook provides the tools you need to bring your narratives to life.
Get started today and captivate your audience with immersive storytelling!
See it in action:
Travel through Cologne (german) (Story-type): https://koeln.adventurebook.net
Travel on the Camino (german) (Game-type): https://camino.gaida.de
Relaxing Journey (english, incl. Google Translate) (Story-type): https://adventurebook.net/relaxing-journey/
The Morning After (german, incl. Google Translate) (Story-type): https://adventurebook.net/der-morgen-danach/
Play Demoworld (english, incl. Google Translate) (Game-type): https://adventurebook.net/play-demoworld/
The “Demoworld” Adventurebook is also included in the premium version of the plugin as demo content to help you get started.
How to Use
After activating the plugin, navigate to the ‘Adventure Books’ menu in your WordPress dashboard.
Click on ‘Add New Adventure Book’ to start creating your adventure book frame. Just enter a title and maybe a short description.
Save the adventure book.
Add pages by editing your adventure book and using the ‘Add New Book Page’ button on the right side of the editor.
Alternatively, you can manage your book pages using the ‘Book Pages’ menu. Be sure to set the filter to the correct book.
When editing a book page, you can add choices by using the ‘Add Decision Option’ button at the bottom.
Each choice can link to another (existing) page in the book, allowing for branching narratives. Be sure to first create the target pages before linking them.
You can add a single image to each book page using the ‘Book Page Image’ option in the editor.
After having added a decision to a page, you can restrict the choice to characters that have a specific item.
This applies to Game-type Adventurebooks.
To do this, choose “Restriction Type” -> “Item” and then enter the code of the item that the character must have to be able to choose this option.
E.g. if you restrict a decision to the item with code “key_gold”, only characters that have this item in their inventory can choose this option.
How to setup a Game-type Adventurebook
Create a page for character management with the shortcode [adventurebook_character_overview].
Set this page in the Adventurebook settings.
Create a new Adventurebook of type “Game”.
Create a page for the book with the shortcode [adventurebook id="X"], where X is the ID of your adventure book.
The adventurebook will be embedded in this page.
Create items in the “Adventurebook Items” menu. You can upload an image for the item and define stats. For details, see below.
Create creatures in the “Adventurebook Creatures” menu. You can upload an image for the creature and define stats. For details, see below.
Create book pages and add item spawns / creature spawns to the pages. For details, see below.
Set the starting page by selecting the bookpage of your choice on the Adventurebook edit page.
Items
Items are defined in the “Adventurebook Items” menu. Every item has a code, a name, a description, stats and an image.
The code is a unique human readable identifier for the item, e.g. “key_gold”.
Stats are depending on the chosen Combat System. In the free version, only the “Simple” combat system is available.
E.g. a longsword could be defined by:
code: sword_longsword
name: Longsword
description: A sharp longsword.
stats: Slot=Weapon,Damage=10,Value=15
image: (upload an image of a longsword)
Creatures
Creatures are defined in the “Adventurebook Creatures” menu. Every creature has a code, a name, a description, hostility, attackability, xp value, stats, loottable and an image.
The code is a unique human readable identifier for the creature, e.g. “goblin”.
Stats are depending on the chosen Combat System. In the free version, only the “Simple” combat system is available.
E.g. a goblin could be defined by:
code: goblin
name: Goblin
description: A small green goblin. Looks hostile.
hostility: hostile
attackability: can be attacked
xp value: 5
stats: Health=20,Damage=5,Armor=2
loottable: sword_longsword:20:1:1,leather_armor:10:1:1
image: (upload an image of a goblin)
The loottable defines which items the creature can drop when defeated. The format is:
item_code:chance:min_amount:max_amount
E.g. sword_longsword:20:1:1 means that the creature has a 20% chance to drop 1 longsword when defeated.
For gold/money, use the item code “money”.
E.g. money:100:5:15 means that the creature will always drop between 5 and 15 gold when defeated.
Combat Systems
To make the plugin more flexible, different combat systems can be chosen.
Currently, only the “Simple” combat system is available in the free version.
In the “Simple” combat system, the currency is set to “Gold”.
Character Stats
Character Stats for the “Simple” combat system are:
Health (Defaults to 35)
CurHealth
Wealth (Gold) (Defaults to 10)
XP (Defaults to 0)
Slots (Defaults to ‘Weapon,Shield,Armor’)
internal use only:
* initiative (Defaults to 0)
* attack (Defaults to 0)
* armor (Defaults to 0)
* defense (Defaults to 0)
Creature Stats
Creature Stats for the “Simple” combat system are:
Health
Damage
Armor
Item Stats
Item Stats for the “Simple” combat system are:
Value
how much (Gold) the item is worth when selling it to a shop
Armor
how much armor the item provides when equipped
Damage
how much damage the item provides when equipped
Slot
if the slot of an item matches any slot of a character, the item can be equipped by the character.
In the Simple Combat System, the available slots are ‘Weapon’, ‘Shield’ and ‘Armor’. Only one item can be equipped per slot.
Examples:
A sword could have the slot ‘Weapon’ and damage 10.
A shield could have the slot ‘Shield’ and armor 5.
A leather armor could have the slot ‘Armor’ and armor 3.
A chain mail could have the slot ‘Armor’ and armor 7.
If a player has a leather armor equipped, his armor stat is 3.
If he equips the chain mail, the leather armor will be unequipped and the armor stat will be 7.
Combat
When a character visits a page with creature spawns, he can choose to attack a creature.
The combat is turn-based. For each turn, the initiative is calculated randomly.
The character and the creature attack each other until one of them has 0 or less health.
If the character wins, he gets XP and Gold (Wealth) according to the creature’s stats. The creature is removed from the page and will respawn after the set respawn time.
If the character loses, he is moved back to the starting page / his respawn point and his health is fully restored.
If the initiative of the character is higher than the initiative of any hostile creature on the page, he surprises the creature and gets a free turn before the combat starts.
If an enemy is not hostile, but can be attacked, the character can choose to attack it, turning it hostile.
Damage dealt: Damage Value (Attacker) – Armor Value (Defender), minimum 1 damage.
Technical Details
The following information is for the Adventurebook Type “Game”.
Item Definitions (table _adventurebook_item_definitions)
Every item in the world/game has a definition. The definition is stored in the table _adventurebook_item_definitions.
The definition contains non-mutable information about the item.
id
code (unique human readable identifier, used for restrictions e.g.)
name
description
stats
image-url
Item Spawns (table _adventurebook_item_spawns)
Defines a spawn point for an item. The spawn point is a zone.
When a new character is created, all items that have a spawn point will be added to the zone (page).
item_id
page_id
Items (table _adventurebook_items)
Defines an item that a character can find in his adventure.
id
code
character_id
location_id
Scripts (table _adventurebook_scripts)
Defines a script that can be attached to a page and is executed when the page is visited / reloaded.
id
code (unique human readable identifier, used to attach the script to a page)
name (will not be displayed to the user)
commands (the commands that will be executed, array in json format)
SCRIPT COMMANDS
Scripts can be attached to book pages and are executed when the page is visited / reloaded, e.g. each time the user clicks on a decision that leads to this page,
or when attacking, equipping, unequipping, buying, selling, using an item.
A script can be attached to an adventurebook page by selecting the script in the “Script” dropdown on the page edit screen.
Every script line needs a unique key (it is a jumpmark).
The second input field is the command. The third input field is optional and can contain parameters for the command, usually separated by “|”.
The following script commands can be used in a script.
output text
Outputs the given text to the user. Supported placeholders:
{var:varname}: Replaced with the value of the game variable “varname”.
{stat:statname}: Replaced with the value of the character’s stat “statname”.
{itemcount:itemcode}: Replaced with the count of the item “itemcode” in the character’s inventory.
{charactername}: Replaced with the name of the character.
output text|text color
Outputs the given text to the user in the given color. Color can be a color name (e.g. “red”) or a hex color (e.g. “#ff0000”).
show_key_link text|key
Outputs the text as a clickable button and links it to a certain key in the script.
add_item item_code
Gives the item with the given code to the character.
remove_item item_code
Removes the item with the given code from the character.
if_item_is_here_goto item_code|key
If the item with the given code is in the current location, jump to the given key in the script.
heal amount
Heals the character by the given amount. If the amount is -1, the character will be fully healed.
stop
Stops the execution of the script and sets the key to 0, so that the script will be executed from the beginning the next time the page is visited.
Script Example
100 output A wooden bench is here.
110 showkeylink Sit down and take a rest|200
120 stop
200 output You sit down on the bench and take a rest. You feel better.|green
210 heal 10
220 stop
Note: The premium version of the plugin comes with different premade scripts.
PLANNED
各版本下載點
- 方法一：點下方版本號的連結下載 ZIP 檔案後，登入網站後台左側選單「外掛」的「安裝外掛」，然後選擇上方的「上傳外掛」，把下載回去的 ZIP 外掛打包檔案上傳上去安裝與啟用。
- 方法二：透過「安裝外掛」的畫面右方搜尋功能，搜尋外掛名稱「Adventurebook」來進行安裝。
（建議使用方法二，確保安裝的版本符合當前運作的 WordPress 環境。
1.0 | 1.0.1 | 1.0.2 | 1.0.3 | 1.0.4 | 1.0.5 | 1.0.6 | 1.0.7 | 1.0.8 | 1.0.9 | trunk | 1.0.10 | 1.0.12 | 1.0.13 | 1.0.15 | 1.0.16 | 1.0.17 | 1.0.18 | 1.0.20 | 1.0.21 |
延伸相關外掛（你可能也想知道）
暫無相關外掛推薦。