NEWS

dndR 3.1.1.900

This is the development version. Changes from the preceding version will be identified here as they are made.

npc_creator() also returns first and last names for NPCs (in addition to race/species and a job).
Updates relevant unit tests for ggplot2 version 4.0.0.

Updates for 2024 version of fifth edition Dungeons & Dragons:
- With the 2024 release of an updated fifth edition, many functions needed to be updated so users could specify which version they were using. In all cases this was added as a ver argument.
- Note that the creature and spell query functions (spell_text(), spell_list(), creature_text(), and creature_list()) use 2014 information and will return a warning if 2024 is specified as the desired version.
- Similarly, encounter balancing rules have changed so xp_cost() will likewise return a warning if the ver = "2024".
- All other functions with a ver argument will behave as appropriate for the specified version.
encounter_creator() supports a try argument that defines how many attempts are made to maximize encounter XP while remaining beneath the allowable XP threshold.
encounter_creator() supports a max_creatures parameter that allows users to specify the maximum number of creatures they want to include in a given encounter.
Namespaced all internal function examples.
Removed all non-ASCII characters from spell and creature information data tables.
Adding unit tests to most functions in the package. Some small changes have resulted (e.g., new warnings for edge cases, more informative messages, etc.).

encounter_creator() picks a set of creature experience point (XP) values that constitute a balanced encounter of specified difficulty and given party composition information.
creature_list() identifies Dungeons & Dragons creatures based on user specifications of various criteria (e.g., creature type, experience point value, size, etc.).
New function: creature_text retrieves full description text of creature(s) specified by user.
Adding support for re-rolling of 1s in roll() result.
Streamlined internal mechanics of roll() such that dice with any number (integer) of faces can be rolled (e.g., "2d57", "d13", etc.).
Adding 5 spells to spell_list() and spell_text() (Antagonize, Gate Seal, Spirit of Death, Spray of Cards, and Warp Sense).
Vignettes restructured into thematic categories.

Fixed non-ASCII apostrophes in spell names (causes failure to find spell with spell_text and spell_list).

spell_list() identifies official Dungeons & Dragons spells based on user specifications of various criteria (e.g., school of magic, which character class list has the spell, casting time, etc.).
spell_text() retrieves full description text of spell(s) specified by user.
probability_plot() makes plot of frequency of dice outcome for specified dice number/type and number of rolls.
mod_calc() identifies roll modifier for a specified ability score.
roll() description clarified and expanded.
Added specific contributing instructions (see CONTRIBUTING.md).
Added function contributor names to the description fields of existing contributed functions (pc_level_calc() and party_diagram()) per CONTRIBUTING.md guidelines.

New supported class: Artificer (Source: "Eberron").
New supported races: Bugbear, Changeling, Goblin, Hobgoblin, Kalashtar, Orc, Shifter, and Warforged (Source: "Eberron").
npc_creator() picks race and job of some number of non-player characters.
pc_level_calc() identifies player level based on earned XP.
roll() supports three-sided dice (i.e., "d3").
roll() includes a show_dice parameter that accepts either TRUE or FALSE (the default). If show_dice = TRUE (and more than one die is rolled), the individual die results will be returned as a message in addition to the sum of their results. Note that the behavior of "2d20" is unchanged and both values are returned as a two-column, one-row dataframe.

First fully functioning version of the package.