Skip to content

Latest commit

 

History

History
60 lines (43 loc) · 4.45 KB

README.md

File metadata and controls

60 lines (43 loc) · 4.45 KB
Raw

TimeOperate-Expansion

Time operating expansion for PlaceholderAPI

Install

  • Download jar file from releases.
  • Put the jar file to /plugins/PlaceholderAPI/expansions/
  • Execute command /papi register <filename> or /papi reload or restart server.

Usage

// Arguments: <Required> [Optional]

%timeoperate_<time>_<display format>[_<time override>]%

Type {placeholder} or (placeholder) if you want to use some placeholders in arguments.

I am not a native English speaker. There are maybe some typo errors.

time

value detail example
now now time now
timestamp timestamp (in seconds) 1675353600
Formatter|value specific format time yyyy-MM-dd|2023-02-03

display format

Use unix for returning timestamp (in seconds).

Or read the DateTimeFormatter Javadoc page about possible formats.
e.g. yyyy-MM-dd (2024-08-10), HH:mm:ss (11:45:14)

time override

value detail example
+DURATION plus time, needed number and unit (ignore case),
  • d means day(s)
  • h means hour(s)
  • m means minute(s)
  • s means second(s)
 +1d2h
-DURATION minus time, needed number and unit (ignore case),
  • d means day(s)
  • h means hour(s)
  • m means minute(s)
  • s means second(s)
 -1d2h
unit=value set specific time, needed unit and number (case sensitivity),
  • y or year means year
  • M or month means month
  • d or day means date
  • h or hour means hour
  • m or minute means minute
  • s or second means second
 y=2023
hour:minute:second set hour, minute and second in a more simple way, type ~ means not modify 4:0:0, 6:0 (full 06:00:00), 20:05 (full 20:05:00), 11:45:14

Support multi overrides, connect them with _.

Examples

// Get timestamp (in second) of tomorrow 6:00
%timeoperate_now_unix_+1d_6:00%

// Get time of tomorrow but minute and second are 0 with custom format
%timeoperate_now_yyyy/MM/dd HH:mm:ss_+1d_~:0:0%

Usage Examples

// give player temp permission by LuckPerms, expire in tomorrow 4:00
/lp user %player_name% permission settemp your.perm.here true %timeoperate_now_unix_+1d_4:00%