School Classes Plus
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> |
|
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 notificationsAdd a command to give class an itemOption 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 classesOption to toggle if students can raise their handsImprove 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.
All Rights Reserved do not decompile the plugin nor re-upload without permission, you may not upload the plugin claiming it is your own
Comments
-
Nipple_Sausage Owner
-
View User Profile
-
Send Message
Posted Jan 6, 2024Hi there ... this sounds like an amazing plugin. Will it be updated to Java 1.20.1 and later the 1.21 update?