Create: Computing AgesDoc Brass
Périphériques

Bloc musical

Le bloc musical de Minecraft piloté par un ordinateur : lire et accorder sa note, lire son instrument, le jouer, contre l'ordinateur ou n'importe où sur son câble.

Le bloc musical de Minecraft est un périphérique : un ordinateur l'accorde et le joue, sans clic et sans redstone. Contrairement à la bibliothèque sound, il ne demande pas de Haut-parleur, et dès le Mini-ordinateur il peut se trouver n'importe où le long du Câble de données de l'ordinateur : un carillon en haut d'une tour, un orchestre de blocs musicaux autour d'une salle, chacun avec son instrument.

Brass
local nb = peripheral.find("note_block")
nb.set_note(12)
nb.play()
Méthodes
nb.note()La note qu'il joue : le nombre de clics reçus, de 0 (un fa#) à 24 (le fa# deux octaves plus haut). Ce sont les mêmes notes que celles de sound.note.
nb.instrument()L'instrument qu'il joue. Il suit les blocs autour de lui à mesure qu'ils changent : posez un bloc d'or dessous, et il lit "bell" tout de suite.
nb.set_note(note)L'accorde, comme des clics, sans le jouer. Le changement s'applique à la fin du tick du programme, une fois, avec la dernière note demandée : note() lit encore l'ancienne note dans le même tick, et sleep(0.05) attend un tick.
nb.play()Joue sa note, comme une impulsion de redstone : le son, la note qui s'en échappe, et une vibration pour les capteurs sculk alentour. Comme set_note, cela se fait à la fin du tick, une fois : l'appeler dix fois dans un tick joue une seule note. Les changements s'appliquent dans l'ordre où le programme les a demandés, donc set_note puis play dans le même tick joue la nouvelle note.

Installation

Le joindre depuis un ordinateur. Tous les ordinateurs le pilotent, Calculateur à tubes compris. Posez-le contre une face de l'ordinateur et appelez-le par cette face, ou, dès le Mini-ordinateur, contre un Câble de données du réseau de l'ordinateur : il s'appelle alors comme note_block@120,64,-35. peripheral.find("note_block") prend le premier et peripheral.list("note_block") donne les noms de tous. Voir Périphériques et Tous les périphériques.

Son instrument vient du bloc posé dessous, comme dans le jeu : un bloc d'or en fait une cloche, du bois une basse, de la pierre lumineuse un pling (la liste complète est sous sound.instruments). Une tête de créature posée dessus lui donne plutôt la voix de cette créature, et la note ne change alors plus sa hauteur.

Étouffé. Tout autre bloc posé dessus le rend muet : play renvoie alors false, comme une impulsion de redstone ne jouerait rien. Le bloc musical joue toujours quand il reçoit de la redstone ou un clic : l'ordinateur ne le confisque pas.

Quand le bloc musical a disparu (cassé, remplacé), chaque méthode arrête le programme avec note block removed ; quand son chunk n'est pas chargé, avec peripheral is not loaded.

Lecture

#

nb.note()

→ number

La note qu'il joue : le nombre de clics reçus, de 0 (un fa#) à 24 (le fa# deux octaves plus haut). Ce sont les mêmes notes que celles de sound.note.

Renvoie
number
sa note, de 0 à 24
Brass
local nb = peripheral.find("note_block")
print("accordé sur " .. nb.note())

Voir aussi note_block.set_note() sound.note()

#

nb.instrument()

→ string

L'instrument qu'il joue. Il suit les blocs autour de lui à mesure qu'ils changent : posez un bloc d'or dessous, et il lit "bell" tout de suite.

Renvoie
string
l'instrument que donne le bloc dessous : "harp", "bass", "bell"..., ou la créature d'une tête posée dessus : "zombie", "skeleton", "creeper", "dragon", "wither_skeleton", "piglin", "custom_head"
Brass
local nb = peripheral.find("note_block")
if nb.instrument() == "bell" then
  print("une cloche, il y a de l'or dessous")
end

Voir aussi sound.instruments()

Accorder et jouer

#

nb.set_note(note)

L'accorde, comme des clics, sans le jouer. Le changement s'applique à la fin du tick du programme, une fois, avec la dernière note demandée : note() lit encore l'ancienne note dans le même tick, et sleep(0.05) attend un tick.

Paramètres
note number
un nombre entier de 0 à 24 ; un plus petit devient 0, un plus grand 24
Brass
local nb = peripheral.find("note_block")
nb.set_note(18)
print(nb.note())   -- encore l'ancienne note
sleep(0.05)
print(nb.note())   -- 18

Une note doit être un nombre entier : nb.set_note(12.5) arrête le programme avec bad argument #1 to 'set_note' (number has no integer representation). Pour les quarts de ton, utilisez sound.note.

Voir aussi note_block.note() note_block.play()

#

nb.play()

→ boolean

Joue sa note, comme une impulsion de redstone : le son, la note qui s'en échappe, et une vibration pour les capteurs sculk alentour. Comme set_note, cela se fait à la fin du tick, une fois : l'appeler dix fois dans un tick joue une seule note. Les changements s'appliquent dans l'ordre où le programme les a demandés, donc set_note puis play dans le même tick joue la nouvelle note.

Renvoie
boolean
true s'il va sonner, false quand un bloc posé dessus l'étouffe

Un carillon : chaque bloc musical du câble joue à son tour, une gamme qui monte de bloc en bloc.

Brass
local cloches = peripheral.list("note_block")
local gamme = {6, 8, 10, 11, 13, 15, 17, 18}
for i, note in ipairs(gamme) do
  local nb = peripheral.wrap(cloches[(i - 1) % #cloches + 1])
  nb.set_note(note)
  nb.play()
  sleep(0.25)
end

Pour un accord sur un seul bloc, ou plus d'une note par tick, utilisez un Haut-parleur et sound.note : un bloc musical joue une note par tick, comme dans le jeu.

Voir aussi note_block.set_note() sound.note()