TutorialCreator - The Ultimate Tutorial Solution! -----
Guide your players with tutorials. Keep them engaged.Update Information
Like the update? ❤️
A lot of effort went into this update. If you like it, a positive review is very much appreciated!
Join the Discord
Join the community Discord for news, feature votes and support!
Add this to your config.yml:
- Introducing the new main GUI! After studying user behavior and re-evaluating the most important functions, the icons, descriptions and layout of the main tutorial editing GUI have been revised. This allows a more intuitive and easier use.
- A new settings menu has been added to change tutorial settings in one place. In the future, movement settings won't be controlled by actions, but will be configured in this GUI.
- You can now also force the saving of individual tutorials.
Like the update? ❤️
A lot of effort went into this update. If you like it, a positive review is very much appreciated!
Join the Discord
Join the community Discord for news, feature votes and support!
Add this to your config.yml:
Code (Text):
messages:
force-saved-tutorial: 'You force-saved the tutorial &e%tutorial%&7.'
force-saved-tutorial: 'You force-saved the tutorial &e%tutorial%&7.'
Update information
- Fixed a warning message in 1.20.2 („Found inconsistent skull meta…“)
- Fixed deny-flight-action not being present in the new-action GUI for Minecraft 1.9
- Extensive internal changes to how different Minecraft versions are handled. This will pay off in future updates, which are currently in progress. Stay tuned!
- The plugin has been extensively tested. However, if new errors occur as a result of the changes, please understand and report them here: Discord / PM
Update information
- A refreshed new-action menu provides a better overview over the actions. They are sorted by relevance, have new names and item types, and are separated between normal actions and movement restrictions. (See image)
- You can now use default timings for titles. Just type '-' as the timings input. Default timings can be configured in the config (see spoiler for all additions.)
- Fixed console warnings when printing information.
- Small GUI improvements.
- Custom names for new tutorial villagers are visible by default.
- Please report any issues via Discord or PM
Code (YAML):
messages:
typetimings : 'Type the fadein, duration and fadeout length in the chat or use "-" for default timings. Example : &o10 6s 10'
default-title-fadein-ticks : 5
default-title-duration-ticks : 80
default-title-fadeout-ticks : 5
typetimings : 'Type the fadein, duration and fadeout length in the chat or use "-" for default timings. Example : &o10 6s 10'
default-title-fadein-ticks : 5
default-title-duration-ticks : 80
default-title-fadeout-ticks : 5
TutorialCreator now supports 1.16
Despite lots of testing there may still be some more bugs. If you can find any please report them to me via Discord, Discussion or Spigot PM. Thanks!
Changelog:
Despite lots of testing there may still be some more bugs. If you can find any please report them to me via Discord, Discussion or Spigot PM. Thanks!
Changelog:
- Support for 1.16
- Updated the test-server to the newest version
- New IP of the test-server is 3.127.120.162
- Added pitch & yaw for the relative teleport action
- When going back from the specific action gui onto the overview site you will now end up on the same page like you started from
- When canceling the tutorial early with /exit the last shown title gets cleared
- Changed some messages (see below)
- Added three new videos to the main plugin page
Code (Text):
messages:
typelocation: 'Type the location you want the player to be teleported to. (&ox y z [yaw pitch]&r&7)'
typerelativelylocation: 'Type the relative coordinates you want the player to be teleported to. Format: x y z [yaw pitch]'
typelocation: 'Type the location you want the player to be teleported to. (&ox y z [yaw pitch]&r&7)'
typerelativelylocation: 'Type the relative coordinates you want the player to be teleported to. Format: x y z [yaw pitch]'
If you like the update I'd be pleased about a nice review!
Despite lots of testing there may still be some more bugs with the new permissions. If you can find any please report them to me via
Discord
, Discussion or
Spigot PM
. Thanks!
Changelog:
Changelog:
- You can now start individual tutorials via command with extra permissions (not only forcestart for other players)
- Completely rewrote the command system for more intuitive usage
- /tutorials - View all tutorials you can start by command
- /tutorial <tutorial> [player] - Start the tutorial for you or a certain player
- /tutedit <tutorial> - Create / Edit a tutorial
- /tutedit - View all tutorials / Reload the plugin / Force-save tutorials
- Fixed playsound-action only allowing a decimal as the pitch (@Tirco)
- Changed the permissions! Check them out on the main site
- Changed the "wrong-syntax" message and added "command-not-for-console" and "only-start-following-tutorials"
Code (Text):
messages:
command-not-for-console: '&4This command can''t be executed from the console.'
only-start-following-tutorials: 'You can start the following tutorials:'
wrong-syntax:
- '&7[&6&lTutorial&r&7] &cWrong syntax!'
- '&c» &7/tutorials &8| &7View all tutorials you can start'
- '&c» &7/tutorial <tutorial> [player] &8| &7Start a tutorial for you or another player'
- '&c» &7/tutedit <tutorial> &8| &7Create / Edit a tutorial'
- '&c» &7/tutedit &8| &7Overview of every tutorial / Reload the plugin / Force-save tutorials'
- '&c» &7/abort &8| &7Exit the chat input'
command-not-for-console: '&4This command can''t be executed from the console.'
only-start-following-tutorials: 'You can start the following tutorials:'
wrong-syntax:
- '&7[&6&lTutorial&r&7] &cWrong syntax!'
- '&c» &7/tutorials &8| &7View all tutorials you can start'
- '&c» &7/tutorial <tutorial> [player] &8| &7Start a tutorial for you or another player'
- '&c» &7/tutedit <tutorial> &8| &7Create / Edit a tutorial'
- '&c» &7/tutedit &8| &7Overview of every tutorial / Reload the plugin / Force-save tutorials'
- '&c» &7/abort &8| &7Exit the chat input'
- You can now allow flying during the tutorial
- Use AllowFlight to enable and DenyFlight to disable (by default disabled)
- The Freeze-Action and LockHead-Action still have higher priority so you need to use the Unfreeze-Action before
- If you have any issues please report them via Discord or PM
I'm working on the update for 1.15 so stay tuned
If you like the update I'd be pleased about a nice review!
- You can now allow the player to fly during the tutorial by using the allow-flight-action and deny-flight-action
- The freeze-action and lock-head-movement-action still have higher priority. Therefore you need to use unfreeze to allow flying if you used one of the two actions before
- If you have any issues please report them via Discord or PM
If you like the update I'd be pleased about a nice review!
- Fixed lagging while having freeze enabled and being in the air
- +2 new Actions: Allow / Block damage (default: blocked)
- Fixed plugin not working in 1.13
- Fixed exceptions when using the own inventory while having the TutorialCreator gui open (you can now still fully use the own inventory)
- Changed info lores for some actions
- If you have any issues please report them via Discord or PM
- Added 4 new actions!
- Freeze player: Stop the player from walking around / flying
- Lock head movement: Stop the player from turning his head
- Unfreeze player: Allow moving and head movement
- Unlock head movement: Only allow head moving but possibly still block walking and flying
- On default you can move and turn your head
- If you have any issues please report them via Discord or PM
- Simply fixed an error with ProtocolLib
- If you came from the /tutorials overview you can now go back to it from the current tutorial GUI (by using the back button one more time)
- You can now manually set a list of commands to be executed when a player leaves a certain tutorial before it ends (view example below)
- Fixed exception when testing certain actions via GUI
- Changed some sound feedback
- Fixed the actionbar also being blocked when "block-other-plugin-messages" was on true
- Fixed the tutorial being stopped when the player used /exit shortly before in another tutorial
Code (YAML):
tutorials:
example:
allow-exit-command : true
back-teleport:
world : world
x : 0.0
y : 50.0
z : 0.0
pitch : 0
yaw : 0
early-exit-commands :
- say %player% left the tutorial "example" early
- say another command.
events :
[ ... ]
example:
allow-exit-command : true
back-teleport:
world : world
x : 0.0
y : 50.0
z : 0.0
pitch : 0
yaw : 0
early-exit-commands :
- say %player% left the tutorial "example" early
- say another command.
events :
[ ... ]
- You can now decide if you want to use ProtocolLib for blocking messages from other plugins
- Add option "block-other-plugin-messages" to your config file!
- Improved the "teleport relatively"-action
Code (YAML):
block-other-plugin-messages
: true
- You can now enter time in seconds or ticks: (20 ticks = 1 second)
- "4s" = 80 ticks = 4 seconds
- "10" = 10 ticks = half a second
- Added lores that explain each action
- Changed which messages get blocked when a player is in a tutorial
- Changed message "typetimings" and "typedelay"
- Other minor improvements
Code (YAML):
messages:
typetimings : 'Type the the fadeIn, the duration and the fadeOut length in ticks (or use "s" for seconds ) into the chat. Example : &o10 5s 20'
typedelay : 'Type the delay in ticks (or use "s" for seconds ) for the new delay into the chat. Example : &o5s'
typetimings : 'Type the the fadeIn, the duration and the fadeOut length in ticks (or use "s" for seconds ) into the chat. Example : &o10 5s 20'
typedelay : 'Type the delay in ticks (or use "s" for seconds ) for the new delay into the chat. Example : &o5s'
- All chat messages from other plugins are now blocked when the player is in a tutorial. Therefore a new dependency is needed: ProtocolLib
- Villager names can now also contain whitespaces
- Fixed invalid "already in a tutorial" message when starting a tutorial through a villager in 1.9 or above
- You now get asked again to enter the chat when the chat-input timer is about to expire
- Add message "enter-chat-now" to your config file!
Code (YAML):
messages:
enter-chat-now : '&cYou have 3 seconds left to send a message.'
enter-chat-now : '&cYou have 3 seconds left to send a message.'
- Fixed some teleport bugs
- Other code improvements
TutorialCreator now supports 1.14
Despite lots of testing there will probably still be some more bugs. If you can find any please report them to me via Discord, Discussion or Spigot PM. Thanks!
Changelog:
Despite lots of testing there will probably still be some more bugs. If you can find any please report them to me via Discord, Discussion or Spigot PM. Thanks!
Changelog:
- Support for 1.14.0 - 1.14.2
- Updated the test-server to the newest version
- Fixed some exceptions regarding villagers in 1.8
- Added the option to turn off the action bar in a tutorial while still allowing the exit command
- Add setting "show-exit-actionbar" to your config file!
Code (YAML):
show-exit-actionbar
: true
- Create a new line with \n in message-actions
- Fixed an exception when interacting with certain villagers
- Changed message "typemessage"
Code (YAML):
messages:
typemessage : 'Type the message for the new action in the chat. Example : &oWelcome %player%!\nThis is my server.'
typemessage : 'Type the message for the new action in the chat. Example : &oWelcome %player%!\nThis is my server.'
Im working on the support for 1.14!
- You can now execute individual actions by clicking the play button in the Apecific-Action-GUI
- Fixed permission check not working correctly for delays
- Other code improvements
- Changed message "villagerspawned"
Code (YAML):
messages:
villagerspawned : 'You successfully created a new tutorial villager. Shift-rightlick to open a GUI.'
villagerspawned : 'You successfully created a new tutorial villager. Shift-rightlick to open a GUI.'
- Increased time to enter the name for a new villager
- Improved sound feedback
- Changed message "wrong-syntax"
Code (YAML):
wrong-syntax
:
- '&7 [&6&lTutorial&r&7 ] &cWrong syntax!'
- '&c» &7/tutorials &8| &7Overview of every tutorial / Reload the plugin / Force-save tutorials'
- '&c» &7/tutorial <name> &8| &7Create / Edit a tutorial'
- '&c» &7/tutorial <name> <player> &8| &7Start the tutorial for a specific player'
- '&c» &7/abort &8| &7Exit the chat input'
- '&7 [&6&lTutorial&r&7 ] &cWrong syntax!'
- '&c» &7/tutorials &8| &7Overview of every tutorial / Reload the plugin / Force-save tutorials'
- '&c» &7/tutorial <name> &8| &7Create / Edit a tutorial'
- '&c» &7/tutorial <name> <player> &8| &7Start the tutorial for a specific player'
- '&c» &7/abort &8| &7Exit the chat input'
- By completely recoding the npc system you can now have multiple villagers with different names that belong to one tutorial
- Fixed the last delay being ignored when no other actions followed
- Fixed small fly bug when finishing a tutorial
- Some message changes (removed messages.villagerrenamed, added messages.villagertypename, changed wrong-syntax)
Code (YAML):
messages:
villagertypename : 'Type the name for the villager in the chat.'
wrong-syntax :
- '&7 [&6&lTutorial&r&7 ] &cWrong syntax!'
- '&c» &7/tutorials &8| &7Overview of every tutorial / Reload the plugin / Force-save tutorials'
- '&c» &7/tutorial <name> &8| &7Create / Edit a tutorial'
- '&c» &7/tutorial <name> <player> &8| &7Start the tutorial for a specific player'
villagertypename : 'Type the name for the villager in the chat.'
wrong-syntax :
- '&7 [&6&lTutorial&r&7 ] &cWrong syntax!'
- '&c» &7/tutorials &8| &7Overview of every tutorial / Reload the plugin / Force-save tutorials'
- '&c» &7/tutorial <name> &8| &7Create / Edit a tutorial'
- '&c» &7/tutorial <name> <player> &8| &7Start the tutorial for a specific player'
- Reloading the config now also checks if the server is in testserver-mode
- Actions console-command and player-command are now also shown in testserver-mode but forbidden for players without the permission "tutorialcreator.bypasstestserver"
- Fixed opening the wrong tutorial in testserver-mode
- Other code improvements
- You can now test the latest version of the plugin at freeforever.minecraft.to (1.7 - 1.13)
- Fixed false detection of someone editing the inventory
- Removed debug outprint (dropped items)
- Fixed exception at certain /tutorial usage
- Improved tab-complete
- Add testserver-mode to your config file! If its true the plugin behaves like on the testserver (new permission: tutorialcreator.bypasstestserver)
Code (YAML):
testserver-mode
: false
- Set a permission for individual actions
- Add messages "type-permission" and "set-permission" to your config file!
Code (YAML):
messages:
type-permission : 'Type the permission for this specific action. ( "-" for no permission ) Example : &otesttutorial.givediamonds'
set-permission : 'You successfully set the permission for this action. ( %perm%)'
type-permission : 'Type the permission for this specific action. ( "-" for no permission ) Example : &otesttutorial.givediamonds'
set-permission : 'You successfully set the permission for this action. ( %perm%)'
- Fixed an exception when trying to start a tutorial via command that has no actions
- Fixed villagers being killable in certain conditions (@Marcobohl)
- Add message "tutempty" to your config file!
Code (YAML):
messages:
tutempty : '&cThis tutorial has no actions.'
tutempty : '&cThis tutorial has no actions.'
- New Villager GUI! (shift+rightclick villager with permission tutorialcreator.removevillager)
- Change the name visibility (@Marcobohl)
- Delete villager
- Info about how to rename him
- New action: Chat-Clear
- New action: Teleport relatively
- You can now use player-variables in the title and message action (%player%)
- Removed message villagerremovequestion
- New messages typechatclear & typerelativelylocation
Code (YAML):
messages:
typechatclear : 'Type the number of empty lines you want to be printed out. Example : &o8'
typerelativelylocation : 'Type the relative coordinates you want the player to be teleported to. Example : &o0 3 0'
typechatclear : 'Type the number of empty lines you want to be printed out. Example : &o8'
typerelativelylocation : 'Type the relative coordinates you want the player to be teleported to. Example : &o0 3 0'
- Fixed players still being invisible after finishing a tutorial + Future compatibility for vanish plugins
- Fixed being able to fly after using /exit in a tutorial
- Fixed false detection of someone editing the inventory
- Fixed calculation error of the execution-time from actions
- Improved the GUI sound feedback
- Small code changes
- New message: changed-cancel-location
Code (Text):
messages:
changed-cancel-location: 'You successfully changed the cancel-location.'
changed-cancel-location: 'You successfully changed the cancel-location.'
- Fixed teleport-actions not being able to create
- Fixed data loss protection bug
Finally I can announce the new TutorialCreator Update v1.5!
After collecting lots of information about requested features, searching for existing bugs and making many thoughts about what to implement next I spend the last month in realizing this update! So here are the most important parts of this update and a list of every news
After collecting lots of information about requested features, searching for existing bugs and making many thoughts about what to implement next I spend the last month in realizing this update! So here are the most important parts of this update and a list of every news
The new GUI:
The new tutorial-list-GUI provides more clarity by listing every existing tutorial in a new GUI. There you can RELOAD the config or the tutorial file by clicking the specific item. Also you can now force-save your edited tutorials. With a simple click on a tutorial you get back in the well-known editing-inventory. You open the inventory with the command /tutorials or /tuts and the permission still is tutorialcreator.edit.
Discord:
To ensure more efficient support in the future you can from now on also contact me via my Discord-server where you can get replies more quickly and help each other.
The Overview Site:
The new overview site presents the plugin in a more graphic way and the persisting color scheme creates a clear appearance. It also gives faster access to the new support possibilities Discord and Spigot PM.
Data loss protection:
The new Data loss protection prevents errors when server-administrator edit tutorials parallel. If you every try to edit a tutorial which currently is opened by someone else you get a warning message.
The new tutorial-list-GUI provides more clarity by listing every existing tutorial in a new GUI. There you can RELOAD the config or the tutorial file by clicking the specific item. Also you can now force-save your edited tutorials. With a simple click on a tutorial you get back in the well-known editing-inventory. You open the inventory with the command /tutorials or /tuts and the permission still is tutorialcreator.edit.
Discord:
To ensure more efficient support in the future you can from now on also contact me via my Discord-server where you can get replies more quickly and help each other.
The Overview Site:
The new overview site presents the plugin in a more graphic way and the persisting color scheme creates a clear appearance. It also gives faster access to the new support possibilities Discord and Spigot PM.
Data loss protection:
The new Data loss protection prevents errors when server-administrator edit tutorials parallel. If you every try to edit a tutorial which currently is opened by someone else you get a warning message.
New Overview Inventory
Plugin presentation site completely redesigned
Config reload function
Tutorial force-save function
Tutorial load function
New Discord Server
Protection against lost data by editing tutorials simultaneously
Messages are now separately saved from the tutorials (config.yml / tutorials.yml)
Many minor code improvements and bug fixes
Plugin presentation site completely redesigned
Config reload function
Tutorial force-save function
Tutorial load function
New Discord Server
Protection against lost data by editing tutorials simultaneously
Messages are now separately saved from the tutorials (config.yml / tutorials.yml)
Many minor code improvements and bug fixes
To update just replace the current plugin file and add the new messages from the spoiler below into the config. The plugin should automatically import your tutorials into a new file. For safety reasons make a backup before you update.
If you like what I did and appreciate my work - rate this update 5 stars
And if you have any problems: just contact me!
If you like what I did and appreciate my work - rate this update 5 stars
And if you have any problems: just contact me!
Code (Text):
wrong-syntax:
- '&7[&6&lTutorial&r&7] &cWrong syntax!'
- '&c» &7/tutorials &8| &7Lists all tutorials in a fancy GUI'
- '&c» &7/tutorial <name> &8| &7Edit a specific tutorial'
- '&c» &7/tutorial <name> <player> &8| &7Start the tutorial for a specific player'
messages:
reloaded-tutorials: 'Successfully loaded &c%count% &7tutorials.'
reloaded-messages: 'Successfully reloaded the config file.'
saved-tutorials: 'Successfully saved the tutorials.'
inv-closed-because-reload: '&cYour inventory needed to be closed because of an reload.'
only-one-tut-editor: '&cYou can''t open a tutorial simultaneously. Currently opened by: %player%'
- '&7[&6&lTutorial&r&7] &cWrong syntax!'
- '&c» &7/tutorials &8| &7Lists all tutorials in a fancy GUI'
- '&c» &7/tutorial <name> &8| &7Edit a specific tutorial'
- '&c» &7/tutorial <name> <player> &8| &7Start the tutorial for a specific player'
messages:
reloaded-tutorials: 'Successfully loaded &c%count% &7tutorials.'
reloaded-messages: 'Successfully reloaded the config file.'
saved-tutorials: 'Successfully saved the tutorials.'
inv-closed-because-reload: '&cYour inventory needed to be closed because of an reload.'
only-one-tut-editor: '&cYou can''t open a tutorial simultaneously. Currently opened by: %player%'
Update:
- Fixed tutorials not loading correctly when using multiworld plugins
- Other small changes
Update:
- Compatibility for Minecraft version 1.13 and 1.13.1
- Changed some skull textures in the gui to make it look fancier
- Fixed a bug when switching sites in the main gui
Update:
- You now get an info message if a tutorial villager could not be spawned
- Added command syntax (/tutorial)
- Replace the plugin file
- Add "wrong-syntax" to your config
Code (Text):
wrong-syntax:
- '&7[&6&lTutorial&r&7] &cWrong syntax!'
- '&c» &7/tutorial <name> &8| &7Edit a tutorial'
- '&c» &7/tutorial <name> <player> &8| &7Start the tutorial for a specific player'
- '&7[&6&lTutorial&r&7] &cWrong syntax!'
- '&c» &7/tutorial <name> &8| &7Edit a tutorial'
- '&c» &7/tutorial <name> <player> &8| &7Start the tutorial for a specific player'
- Add the message "villagerspawn-failed" to the messages section in your config
Code (Text):
messages:
villagerspawn-failed: '&cThe tutorial villager could not be created. Check if any plugin disables entity spawning.'
villagerspawn-failed: '&cThe tutorial villager could not be created. Check if any plugin disables entity spawning.'
Update:
- Fixed inventory titles being too long in some versions
- Replace the plugin file
Update:
- Fixed an exception on every 1.11 server and below
- Replace the plugin file
Update:
- The cancel location can now be configured individually for every tutorial (for the /exit command)
- It can be changed in the main GUI by clicking the hopper item
- Replace the plugin file
Update:
- Tutorials can now be left with the command /exit
- You can choose individually for every tutorial if you want to allow the exit command
- Adjusted the main GUI
- If leaving the tutorial is allowed the player sees a customizable actionbar
- Improved multiple code parts
- Replace the plugin file
- Remove "cancel-gamemode" from your config
- Add the message "exit-actionbar" to the messages section in your config
Code (Text):
messages:
exit-actionbar: '&e&lUse the command /exit to cancel the tutorial'
exit-actionbar: '&e&lUse the command /exit to cancel the tutorial'
Update:
- Added a prefix to all messages by default
- Replace the plugin file
- Add the message "prefix" to your config
- Remove the prefix from every message
Code (Text):
prefix: '&7[&6&lTutorial&r&7] '
Update:
- Now sending a message when an action was successfully created
- Improved some code parts
- Replace the plugin file
- Add the message "createdaction" to the messages section
Code (Text):
messages:
createdaction: '&7[&6&lTutorial&r&7] &aYou successfully created a new %type%-action.'
createdaction: '&7[&6&lTutorial&r&7] &aYou successfully created a new %type%-action.'
Update:
- Fixed teleport coordinates being rounded when restarting the server
- Fixed tutorials not being enforceable from the console (Thanks @Tirco)
- Replace the plugin file
Update:
- You can choose a tutorial that gets shown to players who join the first time
- Fixed precise teleport coordinates being rounded (Thanks @arturek1666)
- Replace the plugin file
- Add "first-join-tutorial: <your tutorial or none>" to your config file
Code (Text):
first-join-tutorial: starter
Update:
- There are now permissions required to start tutorials through villagers (tutorialcreator.start.<tutorial>)
- Fixed title timings not working correctly in 1.10 and below
- Fixed edit permission not being checked correctly
- Added a new message when using wrong syntax while creating a title action
- Replace the plugin file
- Adjust player permissions
- Add the message "invalidtitle" to the messages section
Code (Text):
messages:
invalidtitle: '&7[&6&lTutorial&r&7] &cYou typed an invalid title action. (Use /abort to cancel)'
invalidtitle: '&7[&6&lTutorial&r&7] &cYou typed an invalid title action. (Use /abort to cancel)'
Update:
- Added two new actions: player-command-action and console-command-action
- Replace the plugin file
- Add the message "typeplayercommand" and "typeconsolecommand" to the messages section
Code (Text):
messages:
typeplayercommand: '&7[&6&lTutorial&r&7] Type the command you want to have executed by the player. Example: &ogive %player% diamond_sword'
typeconsolecommand: '&7[&6&lTutorial&r&7] Type the command you want to have executed by the console. Example: &obroadcast %player% just finished the tutorial!'
typeplayercommand: '&7[&6&lTutorial&r&7] Type the command you want to have executed by the player. Example: &ogive %player% diamond_sword'
typeconsolecommand: '&7[&6&lTutorial&r&7] Type the command you want to have executed by the console. Example: &obroadcast %player% just finished the tutorial!'
Resource Information
Author:
----------
Total Downloads:
519
First Release:
Feb 26, 2018
Last Update:
Nov 2, 2024
Category:
---------------
All-Time Rating:
22 ratings
Version
-----
Released:
--------------------
Downloads:
------
Version Rating:
----------------------
-- ratings