ThreadHeader

NOTE: Current version supports 1.8 - 1.13!

Overview

Based on a plugin request for a harry potter role-play server, I created a plugin that allows admins to create a class which is saved to file and can be used after restarts. Once created a class, the professor can ready the class which will broadcast to the whole server and then opens the queue for them to join, they can do this by clicking the text in the chat or by using the /class join command. The class can then be opened by the professor at any time, this will teleport all of the students to the class creation point with their last location saved, and will wait for you to begin the class. The students will be given a book and quill by default. Once the professor has enough students they can begin the class using the start command. The professor will give the students a task and then when the students are ready they can hand in their work with the /handin command. The professor can open an inventory of students work with /gatherwork and obtain it by clicking it. They can then read the work and mark it with /class grade <grade>. The work will be given back to the student and will be rewarded based on the grade they achieved. You can modify, add or remove the grades in the config and the commands too. Once the lesson is over, the professor can end the class and all the students will be teleported back to their last location.

Professor / Admin Commands

Command

Description

Permission

/Class Create <CLASS> <Max-Students>

Professors can create a class at their location and will be saved

class.create

/Class Ready <CLASS>

Shows to the server that this class is ready and allows students to join the queue

class.ready

/Class Open <CLASS>

Professors can open a class and all students in the queue will be teleported to the class

class.open

/Class Start <CLASS>

Starting class will notify students and stop people from joining, will also let students use their class commands.

class.start

/Class End <CLASS>

The professors can end the class returning everyone to their last location

class.end

/Class AddPlayer <Player>

Professors can add players into the class after it has begun

class.addplayer

/Class Grade <GRADE>

Professors can grade the item being held in their main hand

class.grade

/Class List

List all created classes

class.list

/Class Mute

Professors can prevent a class from speaking in chat

class.mute

/Class Call <Player>

Notify class that you have picked a student to speak and will be granted permission to speak even if class is muted. Typing this again will revert.

class.call

/Class Give

Give the class the item stack in your main hand

class.give

/Class Spawn <Player>

Teleport a student to class spawn

class.spawn

/Class SetSpawn <CLASS>

Sets the class spawn at your location

class.setspawn

/Class PRH

Pick a random hand

class.call

/Class CRH

Clear raised hand requests for the PRH command

class.call

/Class Magic

Toggle the magic plugin during classes by NathanWolf

class.magic

/Class ToggleRH

You can toggle when students may raise their hands

class.togglerh

/Class Queue

Shows how many students are in or queued for your class.

class.queue

/Class AddHelper <Player>

Add a helper for the duration of the class without giving them a permission

class.addhelper

/Class RemoveHelper <Player>

Remove a temporary helper.

class.addhelper

Student Commands

Command	Description	Permission
/RH	Allows students to notify the professor that they wish to speak, a message will be shown to the class	class.rh
/HandIn	Opens a GUI for players to insert their work, closing GUI will transfer work to /GatherWork GUI	class.handin
/Class Leave	Player will leave a class and return to their last location	class.leave
/Class Join <CLASS>	Alternatively the player can join a specific class using this command, typing it again will leave the class	class.join

Shortened Permission Nodes

Commands	Description	Permission
Student and professor commands listed above	Give access to all of the plugins commands	class.*
All of students commands shown above	Gives access to the plugins student commands	class.student
Access to /class addplayer, /class kick, /class grade, /class spawn, /class gatherwork	Gives access to some of the professor commands	class.helper

Future Features

~~Add on screen titles for notifications~~
~~Add a command to give class an item~~
~~Option to add prefixes to show class helpers, students and professors~~
Command to view when next class is, and command to set the time.
~~Option to toggle use of the Magic plugin by NathanWolf during classes~~
~~Option to toggle if students can raise their hands~~
~~Improve version support, currently issues with sound effects on different versions.~~

View the configuration file:

# SchoolClasses config by Tango_ / Nipple_Sausage

version: '2.3'
Prefix: '&3[&bCLASS&3] '
Professor-prefix: '[Professor] '
Student-prefix: '[Student] '
Helper-prefix: '[Helper] '
Professor-msg-colour: '&d'
Student-msg-colour: '&f'
Helper-msg-colour: '&c'
Teleport-professors: true
delete_class_on_end: false

# Feel free to edit the commands or add more grades if needed
Rewards:
T:
- mgive %player% sp 0
- msg %player% You got 0 SP!
- eco give %player% 1
P:
- mgive %player% sp 0
- msg %player% You got 0 SP!
- eco give %player% 1
D:
- mgive %player% sp 0
- msg %player% You got 0 SP!
- eco give %player% 1
A:
- mgive %player% sp 1
- eco give %player% 1
E:
- mgive %player% sp 1
O:
- mgive %player% sp 1
O*:
- msg %player% You got 2 SP!
- mgive %player% sp 2

# Messages
no-permission: '&4You do not have permission to do this'
class-ended: '&bClass has ended'
class-started: '&aClass has started!'
class-full: '&4The class is full!'
class-already-started: '&4Class %class% has already started'
class-not-opened: '&4Class %class% has not been opened!'
left-queue: '&4You have left the queue for this class'
joined-queue: '&bYou have joined the queue for this class'
joined-queue-info: '&eWhen the class is ready you will be teleported'
class-joined: '&3%player% &6has joined the class!'
class-doesnt-exist: '&4Class %class% does not exist!'
class-muted: '&bClass has been silenced!'
class-unmuted: '&bClass is no longer silenced!'
work-returned: '&bYour work has been returned!'
queue-kicked: '&4You have been removed from the queue'
left-class: '&3%player% &6has left the class'
class-kicked: ' &4You have been removed from the class!'
class-kicked-info: '&eNote that any handed in work will not be marked or returned'
class-leave: ' &4You have left the class!'
class-leave-info: '&eNote that any handed in work will not be marked or returned'
class-leave-goodbye: Thank you for attending class
class-notify: '&bProfessor &5%professor% &bhas started a &6%class% &bclass'
invalid-usage: '&4Invalid usage! &cPlease check /class help'
rh-out-of-class: '&4You may only use this once class has started'
player-raised-hand: '&3%player% &5raises their hand'
handin-already-submitted: You have already submitted work!
handin-too-much: '&bPlease only hand in one piece of work!'
handin-not-in-class: '&4You are not in a class!'
handin-successful: Work handed in, please don't leave until it has been marked!
player-called: '&6Professor &5%professor% &6has called upon &3%player%'
player-uncalled: '&bYou are no longer called upon'

Images and video will be added soon!

Feel free to comment or message me with any issues or suggestions! If your server uses this message me and I will insert it into this thread.

School Classes Plus