[GEN/TP/ADMN] CommandBook 1.7 - Essential and useful commands (/item, etc.) [1.0.0-R1]

sk89q · Dec 13, 2011

General commands as used on my server since '10. Warping, item giving, time changing, weather changing -- the usual.

Thor command, one of many (video by Rubenbeebl):

Note: You can remove any of these commands from CommandBook using the download link below.

General:

item [-d] <item[:data]> [amount]

give [-d] <target> <item[:data]> [amount]

more [-a] [-i] <target>

online [filter]

motd

intro (play intro music)

midi (play a MIDI file for yourself)

rules

setspawn [destination]

time [world] <time>

weather <'stormy'|'sunny'> [duration] [world]

thunder <'on'|'off'> [duration] [world]

spawnmob [-p] [-d] [-i] [-r] <mob> [count] [location]

kit <kit> [target]

Teleportation:

spawn

tp [target] <destination>

bring <target>

put <target>

call <target> (request a teleport)

Messaging:

broadcast <message>

say <message>

me <message>

msg <target> <message...>

reply <message...>

mute <target>

unmute <target>

Player:

whereami

compass

clear [-a] [target]

slap [-s] [-h|-v] [-d] [target]

rocket [-s] [-h] [target]

barrage [-s] [target]

shock [-s] [target]

thor [target] (get Thor's hammer)

unthor [target] (revoke Thor's hammer)

whois [target]

Utilities:

ping

debug info

debug clock (very accurate server lag benchmark)

Bans:

kick <target> [reason...]

ban [-e] <target> [reason...]

unban <target> [reason...]

Complimentary plugins:

/god /heal /slay: WorldGuard

Warps: MyWarp

Homes: MyHome

/help: Help

Download

CommandBook 1.7
Requirements: Java 6+, WorldEdit, Bukkit build 753+

You need WorldEdit: Install WorldEdit. If you don't want WorldEdit, put WorldEdit.jar in the root folder of your server or in the plugins/CommandBook folder.

If you find CommandBook useful,

How to Use

Documentation

List of commands

List of permissions (on the right)

Issue tracker - Suggest ideas and report problems

Check out my server too!

(CommandBook is open source!)

d00ba · Jun 30, 2011

Confirmed working with Minecraft 1.7_01 and bukkit build 946

poppit · Jun 30, 2011

It would be cool if this would replace the help menu like essentials does, though I like this better than Essentials because ALL of my plugins work now.

TheArcher · Jul 1, 2011

This is a great plugin, I like the all of the customization options! However you need to explain the customization options more, especially for the "message of the day". I keep getting this error:

dwi · Jul 1, 2011

TheArcher: Do not use tabulators in your .yml config files. You have to use only spacebar to move text around.

Snowy007 · Jul 1, 2011

Snowy007 said: ↑
I used to use the 'general' plugin but i switched to this one becouse it looks a lot better. i'm having 3 problems though.
1. button or pressure plate activated doors stay open for a minute. (i might have also seen some other redstone things act weird) This doesn't always happen though. Could it have something to do with locking time?
2. "/item bonemeal" does not work. So i used "/item 351:15" The message "You've been given 1 Ink sac." pops up. I did however get the bonemeal but the message is incorrect.
3. I really wanted the "/item bonemeal" command to work so i thought of adding bonemeal to the config.yml under 'item-names:'
Code:
item-names:
    goldblock: 41
    ice: 79
    dshovel: 277
    dspade: 277
    dpick: 278
    dpickaxe: 278
    daxe: 279
    dsword: 276
    dhoe: 293
    goldingot: 266
    ironingot: 265
    bonemeal: 351:15
This however won't work. It won't recognize id's with damage value's
Never had an answer to this. I figured out that the first problem is indeed when locking the time.
Is there any way to use item ID's with damage value's in the item-names list in config.yml?

also something else.
I have 2 worlds. 1 creative and 1 survival.
Both worlds permissions are exactly the way i want them but there is just 1 little problem...

cheating is still possible in the survival world by using commands in the creative world.
For example.
Someone in creative can give items to people in survival.
People in creative can teleport to people in the survival world.

Is there any solution to this?
So people can't give items or teleport to people in my survival world?

rockiesfan1234 · Jul 1, 2011

I added 3 new ranks to my server. "Architect" "Carpenter and "Sculptor" and i already had "ServerBuilder" as a rank.
i am trying to use the whitelist/blacklist to allow them to spawn ceratin items; and deny lower ranks access to spawn those items. Now serever builder is unable to span things also..
Here is my permissions file

Code:

groups:
    Civil:
        default: true
        info:
            prefix: '&3[&3Civil&3]&f'
            suffix: ''
            build: true
        permissions:
            - 'essentials.rules'
            - 'essentials.motd'
            - 'essentials.spawn'
            - 'essentials.list'
            - 'essentials.msg'
            - 'essentials.warp'
            - 'essentials.sethome'
            - 'essentials.home'
            - 'essentials.tp'
            - 'essentials.afk'
            - 'essentials.signs.buy.use'
            - 'supplysign.access'
            - 'craftbook.mech.elevator.use'
            - 'lwc.protect'
            - 'essentials.back'
            - 'essentials.balance'
            - 'essentials.pay'
            - 'PressurePort.Use'
            - 'commandbook.say.me'
            - 'commandbook.whereami'
            - 'commandbook.whereami.compass'
            - 'commandbook.clear'
            - 'commandbook.call'
            - 'factions.participate'
            - 'factions.create'
            - 'scavenger.scavenge'
            - 'scavenger.scavenge'
            - 'commandbook.items.1'
            - 'commandbook.items.4'
            - 'commandbook.items.5'
            - 'commandbook.items.17'
            - 'commandbook.items.20'
            - 'commandbook.items.24'
            - 'commandbook.items.35'
    TestSubject:
        default: false
        info:
            prefix: '&9[&9TestSubject&9]&f'
            suffix: ''
            build: true
        permissions:
            - 'essentials.rules'
            - 'essentials.motd'
            - 'essentials.spawn'
            - 'essentials.list'
            - 'essentials.msg'
            - 'essentials.warp'
            - 'essentials.sethome'
            - 'essentials.home'
            - 'essentials.tp'
            - 'essentials.afk'
            - 'essentials.signs.buy.use'
            - 'supplysign.access'
            - 'craftbook.mech.elevator.use'
            - 'lwc.protect'
            - 'essentials.back'
            - 'essentials.balance'
            - 'essentials.pay'
            - 'essentials.clearinventory'
            - 'PressurePort.Use'
            - 'commandbook.say.me'
            - 'commandbook.whereami'
            - 'commandbook.whereami.compass'
            - 'commandbook.clear'
            - 'commandbook.call'
            - 'factions.participate'
            - 'factions.create'
            - 'scavenger.scavenge'
            - 'scavenger.scavenge'
            - 'commandbook.items.1'
            - 'commandbook.items.4'
            - 'commandbook.items.5'
            - 'commandbook.items.17'
            - 'commandbook.items.20'
            - 'commandbook.items.24'
            - 'commandbook.items.35'
    Carpenter:
        default: false
        info:
            prefix: '&8[&8Carpenter&8]&f'
            suffix: ''
            build: true
        permissions:
            - 'essentials.item'
            - 'essentials.rules'
            - 'essentials.motd'
            - 'essentials.spawn'
            - 'essentials.list'
            - 'essentials.msg'
            - 'essentials.warp'
            - 'essentials.sethome'
            - 'essentials.home'
            - 'essentials.tp'
            - 'essentials.afk'
            - 'essentials.signs.buy.use'
            - 'supplysign.access'
            - 'craftbook.mech.elevator.use'
            - 'lwc.protect'
            - 'essentials.back'
            - 'essentials.balance'
            - 'essentials.pay'
            - 'PressurePort.Use'
            - 'commandbook.say.me'
            - 'commandbook.whereami'
            - 'commandbook.whereami.compass'
            - 'commandbook.clear'
            - 'commandbook.call'
            - 'factions.participate'
            - 'factions.create'
            - 'scavenger.scavenge'
            - 'commandbook.items.35'
    Sculptor:
        default: false
        info:
            prefix: '&8[&8Sculptor&8]&f'
            suffix: ''
            build: true
        permissions:
            - 'essentials.item'
            - 'essentials.rules'
            - 'essentials.motd'
            - 'essentials.spawn'
            - 'essentials.list'
            - 'essentials.msg'
            - 'essentials.warp'
            - 'essentials.sethome'
            - 'essentials.home'
            - 'essentials.tp'
            - 'essentials.afk'
            - 'essentials.signs.buy.use'
            - 'supplysign.access'
            - 'craftbook.mech.elevator.use'
            - 'lwc.protect'
            - 'essentials.back'
            - 'essentials.balance'
            - 'essentials.pay'
            - 'PressurePort.Use'
            - 'commandbook.say.me'
            - 'commandbook.whereami'
            - 'commandbook.whereami.compass'
            - 'commandbook.clear'
            - 'commandbook.call'
            - 'factions.participate'
            - 'factions.create'
            - 'scavenger.scavenge'
            - 'commandbook.items.1'
            - 'commandbook.items.4'
            - 'commandbook.items.5'
            - 'commandbook.items.17'
            - 'commandbook.items.20'
            - 'commandbook.items.24'
    Architect:
        default: false
        info:
            prefix: '&e[&eArchitect&e]&f'
            suffix: ''
            build: true
        permissions:
            - 'essentials.item'
            - 'essentials.rules'
            - 'essentials.motd'
            - 'essentials.spawn'
            - 'essentials.list'
            - 'essentials.msg'
            - 'essentials.warp'
            - 'essentials.sethome'
            - 'essentials.home'
            - 'essentials.tp'
            - 'essentials.afk'
            - 'essentials.signs.buy.use'
            - 'supplysign.access'
            - 'craftbook.mech.elevator.use'
            - 'lwc.protect'
            - 'essentials.back'
            - 'essentials.balance'
            - 'essentials.pay'
            - 'PressurePort.Use'
            - 'commandbook.say.me'
            - 'commandbook.whereami'
            - 'commandbook.whereami.compass'
            - 'commandbook.clear'
            - 'commandbook.call'
            - 'factions.participate'
            - 'factions.create'
            - 'scavenger.scavenge'
            - 'scavenger.scavenge'
            - 'commandbook.items'
    Jr.Hitman:
        default: false
        info:
            prefix: '&b[&bJr.Hitman&b]&f'
            suffix: ''
            build: true
        permissions:
            - 'essentials.rules'
            - 'essentials.motd'
            - 'essentials.spawn'
            - 'essentials.list'
            - 'essentials.msg'
            - 'essentials.warp'
            - 'essentials.sethome'
            - 'essentials.home'
            - 'essentials.tp'
            - 'essentials.afk'
            - 'essentials.signs.buy.use'
            - 'supplysign.access'
            - 'craftbook.mech.elevator.use'
            - 'lwc.protect'
            - 'essentials.back'
            - 'iConomy.access'
            - 'iConomy.payment'
            - 'PressurePort.Use'
            - 'commandbook.say.me'
            - 'commandbook.whereami'
            - 'commandbook.whereami.compass'
            - 'commandbook.clear'
            - 'commandbook.call'
            - 'factions.participate'
            - 'factions.create'
            - 'commandbook.shock'
            - 'scavenger.scavenge'
            - 'scavenger.scavenge'
            - 'commandbook.items.1'
            - 'commandbook.items.4'
            - 'commandbook.items.5'
            - 'commandbook.items.17'
            - 'commandbook.items.20'
            - 'commandbook.items.24'
            - 'commandbook.items.35'
    ApprenticeHitman:
        default: false
        info:
            prefix: '&d[&dAprrenticeHitman&d]&f'
            suffix: ''
            build: true
        permissions:
            - 'essentials.rules'
            - 'essentials.motd'
            - 'essentials.spawn'
            - 'essentials.list'
            - 'essentials.msg'
            - 'essentials.warp'
            - 'essentials.sethome'
            - 'essentials.home'
            - 'essentials.tp'
            - 'essentials.afk'
            - 'essentials.signs.buy.use'
            - 'supplysign.access'
            - 'craftbook.mech.elevator.use'
            - 'lwc.protect'
            - 'essentials.back'
            - 'iConomy.access'
            - 'iConomy.payment'
            - 'PressurePort.Use'
            - 'commandbook.say.me'
            - 'commandbook.whereami'
            - 'commandbook.whereami.compass'
            - 'commandbook.clear'
            - 'commandbook.call'
            - 'factions.participate'
            - 'factions.create'
            - 'commandbook.shock'
            - 'worldguard.slay'
            - 'worldguard.slay.other'
            - 'scavenger.scavenge'
            - 'scavenger.scavenge'
            - 'commandbook.items.1'
            - 'commandbook.items.4'
            - 'commandbook.items.5'
            - 'commandbook.items.17'
            - 'commandbook.items.20'
            - 'commandbook.items.24'
            - 'commandbook.items.35'
    ServerBuilder:
        default: false
        info:
            prefix: '&2[&2ServerBuilder&2]&f'
            suffix: ''
            build: true
        permissions:
            - 'commandbook.override.any-item'
            - 'essentials.give.*'
            - 'essentials.rules'
            - 'essentials.motd'
            - 'essentials.spawn'
            - 'essentials.list'
            - 'essentials.msg'
            - 'essentials.warp'
            - 'essentials.sethome'
            - 'essentials.home'
            - 'essentials.tp'
            - 'essentials.signs.buy.use'
            - 'supplysign.access'
            - 'craftbook.mech.elevator.use'
            - 'lwc.protect'
            - 'essentials.back'
            - 'iConomy.access'
            - 'iConomy.payment'
            - 'PressurePort.Use'
            - 'nocheat.*'
            - 'magiccarpet.mc'
            - 'magiccarpet.ml'
            - 'factions.participate'
            - 'factions.create'
            - 'commandbook.say.me'
            - 'commandbook.whereami'
            - 'commandbook.whereami.compass'
            - 'commandbook.clear'
            - 'commandbook.call'
            - 'scavenger.scavenge'
    Moderator:
        default: false
        info:
            prefix: '&1[&1Moderator&1]&f'
            suffix: ''
            build: true
        permissions:
            - '*'
    Warlord:
        default: false
        info:
            prefix: '&6[&6Warlord&6]&f'
            suffix: ''
            build: true
        permissions:
            - '*'
    Thor:
        default: false
        info:
            prefix: '&e[&bThor/&eHitman&b]&f'
            suffix: ''
            build: true
        permissions:
            - '*'
    King-Owner:
        default: false
        info:
            prefix: '&4[&4King-Owner&4]&f'
            suffix: ''
            build: true
        permissions:
            - '*'
    Poseidon:
        default: false
        info:
            prefix: '&9[&1P&4o&es&5e&2i&dd&6o&3n&9]&f'
            suffix: ''
            build: true
        permissions:
            - '*'
    KingOfTheOzone:
        default: false
        info:
            prefix: '&4[&4KingOfTheOzone&4]&f'
            suffix: ''
            build: true
        permissions:
            - '*'

bollycow · Jul 1, 2011

I just installed the addon but I'm getting a message in the game that I don't have permission. The only installed addons is the worldedit, commandbook. I did not install the Groupmanager/Permission plugin.

BFC_Mike · Jul 1, 2011

bollycow said: ↑

I just installed the addon but I'm getting a message in the game that I don't have permission. The only installed addons is the worldedit, commandbook. I did not install the Groupmanager/Permission plugin.

OP yourself by using /op <yourname> in the console

tommydrum · Jul 1, 2011

mind giving us a updated items.db for 1.7.2?

and making it where it disables op's /give command so it doesnt give you the same thing twice?

Slixor · Jul 1, 2011

Please, can someone tell me how to disable the /give command

this is all I want to do

PLEASE

sillyrosster · Jul 1, 2011

Slixor said: ↑

Please, can someone tell me how to disable the /give command

this is all I want to do

PLEASE

CommandBook has a nifty customize option. You can take out any command.

stargateanubis14 · Jul 1, 2011

is it possible to give permission the /getpos command, without the [target]? For a PVP survival server, people trying to hide bases, and all you need to do is /compass [player] or /getpos [player], it makes it pretty easy to find someone who's trying to hide

Phealoon · Jul 1, 2011

How come I set it to disable pistons, yet they can still be created and used?

Taranis01 · Jul 1, 2011

@Phealoon
wtf ur asking here about disabeling pistons?
http://forums.bukkit.org/threads/admn-pistonblocker-block-the-buggy-pistons-1-7_rb.23858/

CommandBook is died for me because some command doesnt work and there are no bugfixes/sk889q just doesnt care about the problems.
Also many requests, not seen by the developer.

Matt Gill · Jul 1, 2011

Not working for me in build 953.

Here is my console:

C:\Users\Matt\Desktop\Minecraft Server folders\TempMap>java -Xmx2560M -XXarall
elGCThreads=8 -server -Xincgc -XX:+UseConcMarkSweepGC -XX:+UseParNewGC -XX:+CMSI
ncrementalPacing -XX:+AggressiveOpts -XX:+CMSParallelRemarkEnabled -XX:+DisableE
xplicitGC -XX:MaxGCPauseMillis=500 -XX:SurvivorRatio=16 -XX:TargetSurvivorRatio=
90 -XX:+UseAdaptiveGCBoundary -XX:-UseGCOverheadLimit -Xnoclassgc -XX:UseSSE=3 -
XXermSize=128m -XX:LargePageSizeInBytes=4m -jar craftbukkit.jar nogui
151 recipes
16 achievements
15:49:04 [INFO] Starting minecraft server version Beta 1.7.2
15:49:04 [INFO] Loading properties
15:49:04 [INFO] Starting Minecraft server on *:25565
15:49:04 [INFO] This server is running Craftbukkit version git-Bukkit-0.0.0-904-
g9277096-b953jnks (MC: 1.7.2)
15:49:05 [SEVERE] Could not load 'plugins\CommandBook.jar' in folder 'plugins':

java.lang.NoClassDefFoundError: com/sk89q/minecraft/util/commands/CommandExcepti
on
at java.lang.Class.forName0(Native Method)
at java.lang.Class.forName(Unknown Source)
at org.bukkit.plugin.java.JavaPluginLoader.loadPlugin(JavaPluginLoader.j
ava:168)
at org.bukkit.plugin.SimplePluginManager.loadPlugin(SimplePluginManager.
java:199)
at org.bukkit.plugin.SimplePluginManager.loadPlugins(SimplePluginManager
.java:122)
at org.bukkit.craftbukkit.CraftServer.loadPlugins(CraftServer.java:118)
at org.bukkit.craftbukkit.CraftServer.<init>(CraftServer.java:89)
at net.minecraft.server.ServerConfigurationManager.<init>(ServerConfigur
ationManager.java:51)
at net.minecraft.server.MinecraftServer.init(MinecraftServer.java:132)
at net.minecraft.server.MinecraftServer.run(MinecraftServer.java:335)
at net.minecraft.server.ThreadServerApplication.run(SourceFile:422)
Caused by: java.lang.ClassNotFoundException: com.sk89q.minecraft.util.commands.C
ommandException
at java.net.URLClassLoader$1.run(Unknown Source)
at java.security.AccessController.doPrivileged(Native Method)
at java.net.URLClassLoader.findClass(Unknown Source)
at org.bukkit.plugin.java.PluginClassLoader.findClass(PluginClassLoader.
java:36)
at org.bukkit.plugin.java.PluginClassLoader.findClass(PluginClassLoader.
java:24)
at java.lang.ClassLoader.loadClass(Unknown Source)
at java.lang.ClassLoader.loadClass(Unknown Source)
... 11 more
15:49:05 [INFO] LWC Loading shared objects
15:49:05 [INFO] Cache Protection cache: 0/10000
15:49:05 [INFO] LWC Native library: plugins/LWC/lib/native/Windows/amd64/sql
itejdbc.dll
15:49:06 [INFO] [Permissions] (Yeti) was initialized.
15:49:06 [INFO] [Permissions] version [3.1.6] (Yeti) loaded
15:49:06 [INFO] Preparing level "world"
15:49:06 [INFO] Preparing start region for level 0 (Seed: -3879852943714005568)
15:49:07 [INFO] Preparing start region for level 1 (Seed: -8563700962754984346)
15:49:07 [INFO] Preparing spawn area: 16%
15:49:07 [INFO] LWC Loaded 134 locale strings (0 overrides)
15:49:07 [INFO] LWC Using Permissions API...
15:49:07 [INFO] LWC Loading SQLite
15:49:07 [INFO] SQLite Using: Native
15:49:07 [INFO] LWC At version: v3.11
15:49:07 [INFO] [MYHOME]: 10 homes loaded
15:49:08 [INFO] [MYHOME] Permissions enabled using: Permissions v3.1.6
15:49:08 [WARNING] [MYHOME] 'Help' isn't detected. No /help support.
15:49:08 [INFO] [MYHOME] MyHome 1.9.5 enabled
15:49:08 [INFO] [iChat] Found Permissions (v3.1.6)
15:49:08 [INFO] iChat (v2.3.2-p3) enabled
15:49:08 [INFO] [NoCheat] version [1.07] couldn't find CrafTIRC plugin. Disablin
g logging to IRC.
15:49:08 [INFO] [NoCheat] version [1.07] is enabled with the following checks: m
oving speedhack flying fastswim
15:49:08 [INFO] Done (0.185s)! For help, type "help" or "?"

Jeyge · Jul 1, 2011

@Matt Gill
You missed the "requires WorldEdit" portion of the OP.

Phealoon · Jul 1, 2011

@Taranis01

What do u mean "wtf", pistons are causing ALL sorts of issues between the stupid duplicator block, to griefing protected homes,.. not to mention the lag.

Gangsta_hotdog · Jul 1, 2011

Any ideas on when this will be updated to support giving pistons? It's kinda annoying that I can't type /give player piston. I mean how long does it take to add like a line of code? :3

puyttre · Jul 1, 2011

29 = sticky piston
33 = piston

cookiesui · Jul 2, 2011

so i'm a noob, i know it says 860+, but can anyone cofirm this works for 953?

TheArcher · Jul 2, 2011

dwi said: ↑

TheArcher: Do not use tabulators in your .yml config files. You have to use only spacebar to move text around.

Problem solved. it would be a good idea to make it more apparent to replace tabs with spaces on the thread (or in the documentation). It would also be helpful to give examples as to how color codes should be inserted into text to make the text appear that color.

Taranis01 · Jul 2, 2011

@Phealoon
and why should CommandBook care about issues with pistons? Dont understand what have Pistons to do with this Plugin
@Gangsta_hotdog
as i already told sk89q never wrote anything at the last 10 or 20 pages of this thread. Also no bugfixes and reading the new suggestions. How long it will take adding a line of code? Years.
But u should be able to use the IDs, (see puyttre's answer).

Madogi · Jul 2, 2011

For people using the 1.5.3 here are the permissions for /sethome and /home

commandbook.home.set
commandbook.home.teleport

Phealoon · Jul 2, 2011

@Taranis01

Because command book has the option to disallow blocks, so I wouldn't have to install yet another pluging to do something command book already offers.

Desantos · Jul 2, 2011

When there will be assemblages 953 +?

Taranis01 · Jul 2, 2011

@Gangsta_hotdog
you also could use the feature for creating own alias-names for blocks ( "item-names" )

@Phealoon
u can only disallow block for spawning with /i or /give.

Madogi · Jul 2, 2011

Desantos said: ↑

When there will be assemblages 953 +?

http://build.sk89q.com/job/CommandB...rtifact/target/commandbook-1.5.3-SNAPSHOT.jar

Remember to rename it

Sayshal · Jul 2, 2011

I heard I can disable bed spawns with CommandBook.. How?

tom327 · Jul 3, 2011

does anyone know how to spawn spider jockeys or colored sheep with /spawnmob? it says you can do that on the wiki, but i cant figure it out

wizjany · Jul 3, 2011

tom327 said: ↑

does anyone know how to spawn spider jockeys or colored sheep with /spawnmob? it says you can do that on the wiki, but i cant figure it out

using a dev build, /spawnmob spider|skeleton and /spawnmob sheep:color (eg sheep:blue, sheep:green, sheep:random)

Log in or Sign up

[GEN/TP/ADMN] CommandBook 1.7 - Essential and useful commands (/item, etc.) [1.0.0-R1]

sk89q Bukkit Team Member Moderator

d00ba

poppit

TheArcher

dwi

Snowy007

rockiesfan1234

bollycow

BFC_Mike

tommydrum

Slixor

sillyrosster

stargateanubis14

Phealoon

Taranis01

Matt Gill

Jeyge

Phealoon

Gangsta_hotdog

puyttre

cookiesui

TheArcher

Taranis01

Madogi

Phealoon

Desantos

Taranis01

Madogi

Sayshal

tom327

wizjany

Share This Page

[GEN/TP/ADMN] CommandBook 1.7 - Essential and useful commands (/item, etc.) [1.0.0-R1]

sk89q Bukkit Team Member Moderator

Share This Page

Useful Searches