Vampire Character Manager

For managing characters for LARPs and online vampire games.

Author:Jane Houston (profile at wordpress.org)
WordPress version required:5.2.4
WordPress version tested:6.3.2
Plugin version:2.13
Added to WordPress repository:11-11-2015
Last updated:05-11-2023
Rating, %:100
Rated by:1
Plugin URI:http://plugin.gvlarp.com
Total downloads:3 023
Active installs:10+
plugin download
Click to start download

This WordPress plugin is intended to manage vampire character sheets for LARPs and online vampire games.

Features are:

  • Online character generation
  • Track and assign changes in Experience and other ratings
  • Output a PDF character for printing
  • Configure character generation rules using templates
  • Configure experience point and freebie point costs
  • Add/Edit character and source data
  • Storyteller approval of XP spends and character background updates
  • Display area map using Google API
  • Automatically list active characters and what their status is
  • Get reports (CSV and PDF) such as character activity
  • In-character Private Messaging system
  • Send a newsletter with Experience point totals
  • Can send notification emails via Mail or SMTP
  • Export and import the database to create and restore backups
  • (new) Custom WordPress REST API endpoints to allow integration with other applications

Shortcodes

background_table

Display a list of characters with a specific Background. Defaults are highlighted.

Options:

  • character – WordPress login name of character to be ‘logged in’ as (ST/admin only)
  • background – which background to list (defaults to Status)
  • liststatus – only list characters with a specific character status (Alive, Missing, Dead, Staked, Torpor)
  • level – only list characters with a specific level of background (all, displayzeros, )
  • domain – only list characters in a specific domain (home, )
  • heading – show or hide table headings (1, 0)
  • columns – define which columns to display in a comma-separated list (level, character, player, clan, domain, background, sector, comment, level, office, sect)
  • matchtype – advanced filtering options. Specify what kind of match to make:
    • sector – list backgrounds that match the specified sector
    • comment – list backgrounds that match the specified comment/specialisation
    • characteristic – list backgrounds that match a characteristic from a character
  • match – use with matchtype. Specify what to filter on/match to
    • loggedinclan – list matches with the clan of the logged in user
    • loggedinsect – list matches with the sect of the logged in user
    • – list matches the selected level

Examples:

  • Display all active characters in the current domain

[background_table level=displayzeros columns=”character,clan,office”]

  • Display all dead characters

[background_table columns=”character,clan,player” level=displayzeros court=”” liststatus=Dead]

  • Display a list of vampires with Clan Prestige in the same clan as you (logged in)

[background_table columns=”level,character,clan” match=loggedinclan matchtype=comment background=”Clan Prestige”]

Note that for this to work, on the character sheet the character must have the clan name entered
into the comment/specialisation box for the background.

character_detail_block

Display character information for the logged in character.

Options:

  • character – WordPress login name of character to be ‘logged in’ as (ST/admin only)
  • group – Sub-group of information to display
    • char_name – character name
    • domain – domain of residence
    • pub_clan – public clan, i.e. the clan that they publicly admit to being a member of
    • priv_clan – private clan, i.e the clan they actually are
    • sire – Name of Sire
    • gen – generation
    • blood_per_round – number of blood points that can be spent per round
    • path_name – Path of Enlightenment name
    • path_value – Level of Path of Enlightenment
    • bloodpool – Size of the bloodpool
    • nature – Character nature (if used)
    • demeanour – Character demeanour (if used, and note UK spelling)
    • date_of_birth – Date of Birth
    • date_of_embrace – Date of Embrace
    • status – Character Status (e.g. Alive, Dead)
    • status_comment – Comment on character status
    • last_updated – date character was last updated (e.g. XP spent)

“Your character was last updated on [character_detail_block group=last_updated].”

character_offices_block

Display the Offices of the logged-in character

Options:

  • character – WordPress login name of character to be ‘logged in’ as (ST/admin only)

[character_offices_block]

character_road_or_path_table

Display Path of Enlightenment changes for the logged-in character

Options:

  • character – WordPress login name of character to be ‘logged in’ as (ST/admin only)
  • group – Sub-group of information to display
    • total – current path level

[character_road_or_path_table]

“Your path rating is [character_road_or_path_table group=total].”

character_temp_stats

Show information on Willpower or Blood spends

Options:

  • character – WordPress login name of character to be ‘logged in’ as (ST/admin only)
  • showtable – show changes in a table (0, 1)
  • limit – limit how many rows in the table (defaults to 5)
  • stat – specify which stat to display (Willpower, Blood)

[character_temp_stats showtable=1 limit=10 stat=Blood]

character_xp_table

List the XP spends and assignments for the logged in character

Options:

  • character – WordPress login name of character to be ‘logged in’ as (ST/admin only)
  • maxrecords – limit how many rows in the table (defaults to 20)

[character_xp_table maxrecords=100]

feeding_map

Display the domain/feeding map. Domains and who owns them are defined in the Data Tables
admin section. You will need a valid Google API code for this feature to work.
(https://developers.google.com/maps/documentation/javascript/tutorial)

[feeding_map]

merit_table

Displays a table of characters with a specific Merit or Flaw.

Options:

  • character – WordPress login name of character to be ‘logged in’ as (ST/admin only)
  • merit – Merit or Flaw name to list (Default is “Clan Friendship”)
  • match – add a filter to the list
    • loggedinclan – Comment/specialisation must match that of the clan of the logged in user
    • – match the specified value
  • liststatus – only list characters with a specific character status (Alive, Missing, Dead, Staked, Torpor)
  • heading – show or hide table headings (1, 0)
  • domain – only list characters in a specific domain (home, )
  • columns – define which columns to display in a comma-separated list (level, character, player, clan, domain, merit, comment, level, sect)

For example, display a list of character with Enmity towards your clan

[merit_table merit=’Clan Enmity’ match=loggedinclan]

office_block

List all the characters with an office or position of power

Options:

  • character – WordPress login name of character to be ‘logged in’ as (ST/admin only)
  • domain – domain character is an official in
  • office – specific office to display

“The ruler of Glasgow is [office_block domain=Glasgow office=Prince].”

spend_button

Displays a button for characters to click to spend Willpower or Bloodpoints.

Options:

  • character – WordPress login name of character to be ‘logged in’ as (ST/admin only)
  • stat – which Stat the button is for:
    • Willpower
    • Blood

inbox_summary

List the last x private messages.

Options:

  • list – define what messages to display

[inbox_summary list=5]

Widgets

Character Login Widget

Displays useful links:

  • Login/logout
  • Character Sheet
  • Character Profile
  • Spend Experience
  • Character Inbox (x unread)
  • Addressbook
  • Contact Details

Character Background Widget

Displays how much of the character background has been completed.

Sunset/Sunrise Times

Display the times of sunset and sunrise.

WordPress REST API Endpoints

  • /wp-json/vampire-character/v1/character : return a list of the active characters (Storyteller only)
  • /wp-json/vampire-character/v1/character/ : return character information by character ID (Storyteller only)
  • /wp-json/vampire-character/v1/character/wpid&wordpress_id= : return character information by wordpress username
  • /wp-json/vampire-character/v1/character/me : return character information for logged-in user

Template Tags

None

Screenshots
FAQ
ChangeLog