| … | |
… | |
| 2742 | =item $player_object->may ("access") |
2742 | =item $player_object->may ("access") |
| 2743 | |
2743 | |
| 2744 | Returns wether the given player is authorized to access resource "access" |
2744 | Returns wether the given player is authorized to access resource "access" |
| 2745 | (e.g. "command_wizcast"). |
2745 | (e.g. "command_wizcast"). |
| 2746 | |
2746 | |
|
|
2747 | This is implemented by checking a config setting of C<may_access> where |
|
|
2748 | C<access> is replaced by the access string. The following alternatives are |
|
|
2749 | possible (and are tested in order): |
|
|
2750 | |
|
|
2751 | =over 4 |
|
|
2752 | |
|
|
2753 | =item * Player is DM |
|
|
2754 | |
|
|
2755 | The request will succeed. |
|
|
2756 | |
|
|
2757 | =item * may_access is an array reference |
|
|
2758 | |
|
|
2759 | If either the player nickname or UUID is in the array, the request will |
|
|
2760 | succeed, otherwise it will fail. |
|
|
2761 | |
|
|
2762 | =item * may_access is a true value |
|
|
2763 | |
|
|
2764 | The request will succeed. |
|
|
2765 | |
|
|
2766 | =item * may_access is missing or false |
|
|
2767 | |
|
|
2768 | The request will fail. |
|
|
2769 | |
|
|
2770 | =back |
|
|
2771 | |
| 2747 | =cut |
2772 | =cut |
| 2748 | |
2773 | |
| 2749 | sub cf::object::player::may { |
2774 | sub cf::object::player::may { |
| 2750 | my ($self, $access) = @_; |
2775 | my ($self, $access) = @_; |
| 2751 | |
2776 | |
| 2752 | $self->flag (cf::FLAG_WIZ) || |
2777 | $self->flag (cf::FLAG_WIZ) || |
| 2753 | (ref $cf::CFG{"may_$access"} |
2778 | (ref $cf::CFG{"may_$access"} |
| 2754 | ? scalar grep $self->name eq $_, @{$cf::CFG{"may_$access"}} |
2779 | ? scalar grep $self->name eq $_ || $self->uuid eq $_, @{$cf::CFG{"may_$access"}} |
| 2755 | : $cf::CFG{"may_$access"}) |
2780 | : $cf::CFG{"may_$access"}) |
| 2756 | } |
2781 | } |
| 2757 | |
2782 | |
| 2758 | =item $player_object->enter_link |
2783 | =item $player_object->enter_link |
| 2759 | |
2784 | |
| … | |
… | |
| 2762 | The player should be reasonably safe there for short amounts of time (e.g. |
2787 | The player should be reasonably safe there for short amounts of time (e.g. |
| 2763 | for loading a map). You I<MUST> call C<leave_link> as soon as possible, |
2788 | for loading a map). You I<MUST> call C<leave_link> as soon as possible, |
| 2764 | though, as the player cannot control the character while it is on the link |
2789 | though, as the player cannot control the character while it is on the link |
| 2765 | map. |
2790 | map. |
| 2766 | |
2791 | |
| 2767 | Will never block. |
2792 | This method will never block, which is the whole reaosn for it's |
|
|
2793 | existance: you can I<always> put a player onto the link map, which is the |
|
|
2794 | only place to put objects that is guaranteed to exist. |
|
|
2795 | |
|
|
2796 | A typical usage pattern is to call C<enter_link> synchronously from the |
|
|
2797 | server, then start a new thread, do your blocking stuff there and then |
|
|
2798 | call C<leave_link> from that thread. |
| 2768 | |
2799 | |
| 2769 | =item $player_object->leave_link ($map, $x, $y) |
2800 | =item $player_object->leave_link ($map, $x, $y) |
| 2770 | |
2801 | |
| 2771 | Moves the player out of the special C<{link}> map onto the specified |
2802 | Moves the player out of the special C<{link}> map onto the specified |
| 2772 | map. If the map is not valid (or omitted), the player will be moved back |
2803 | map. If the map is not valid (or omitted), the player will be moved back |
